IMFByteStream::GetCapabilities メソッド (mfobjects.h)

  • [アーティクル]

バイト ストリームの特性を取得します。

構文

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

パラメーター

[out] pdwCapabilities

0 個以上のフラグのビットごとの OR を受け取ります。 次のフラグが定義されています。

値 意味
MFBYTESTREAM_IS_READABLE
0x00000001
 バイト ストリームを読み取ることができます。
MFBYTESTREAM_IS_WRITABLE
0x00000002
 バイト ストリームは に書き込むことができます。
MFBYTESTREAM_IS_SEEKABLE
0x00000004
 バイト ストリームをシークできます。
MFBYTESTREAM_IS_REMOTE
0x00000008
 バイト ストリームは、ネットワークなどのリモート ソースからのストリームです。
MFBYTESTREAM_IS_DIRECTORY
0x00000080
 バイト ストリームはファイル ディレクトリを表します。
MFBYTESTREAM_HAS_SLOW_SEEK
0x00000100
 このストリーム内でのシークが遅くなる可能性があります。 たとえば、バイト ストリームはネットワークからダウンロードできます。
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED
0x00000200
 バイト ストリームは現在、ローカル キャッシュにデータをダウンロードしています。 バイト ストリームに対する読み取り操作は、データが完全にダウンロードされるまでに時間がかかる場合があります。

このフラグは、すべてのデータがダウンロードされた後にクリアされます。

MFBYTESTREAM_HAS_SLOW_SEEK フラグも設定されている場合は、バイト ストリームがファイル全体を順番にダウンロードする必要があります。 それ以外の場合、バイト ストリームは、ストリーム内の新しいポイントからダウンロードを再開することで、シーク要求に応答できます。
MFBYTESTREAM_SHARE_WRITE
0x00000400
 別のスレッドまたはプロセスで、このバイト ストリームを書き込み用に開くことができます。 このフラグが存在する場合、バイト ストリームの長さは読み取り中に変更される可能性があります。

このフラグは、バイト ストリーム ハンドラーの動作に影響を与える可能性があります。 詳細については、「 MF_BYTESTREAMHANDLER_ACCEPTS_SHARE_WRITE」を参照してください。

メモ Windows 7 以降が必要です。
 
MFBYTESTREAM_DOES_NOT_USE_NETWORK
0x00000800
 バイト ストリームは現在、コンテンツを受信するためにネットワークを使用していません。 このビットが設定されている場合、ネットワーク ハードウェアは省電力状態になることがあります。
メモWindows 8以降が必要です。
 

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

  • Service Pack 2 (SP2) 以降の Windows XP。
  • Windows XP Media Center Edition 2005 と KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfobjects.h (Mfidl.h を含む)
Library Mfuuid.lib

こちらもご覧ください

IMFByteStream