IMFSample::GetBufferByIndex メソッド (mfobjects.h)

  • [アーティクル]

インデックスを使用して、サンプルからバッファーを取得します。

メモ ほとんどの場合、 IMFSample::ConvertToContiguousBuffer メソッドを使用する方が安全です。 サンプルに複数のバッファーが含まれている場合、 ConvertToContiguousBuffer メソッドはそれらを 1 つのバッファーに置き換え、元のデータをそのバッファーにコピーし、新しいバッファーを呼び出し元に返します。 コピー操作は、最大で 1 回実行されます。 後続の呼び出しでは、データはコピーされません。
 

構文

HRESULT GetBufferByIndex(
  [in]  DWORD          dwIndex,
  [out] IMFMediaBuffer **ppBuffer
);

パラメーター

[in] dwIndex

バッファーのインデックス。 サンプル内のバッファーの数を見つけるには、 IMFSample::GetBufferCount を呼び出します。 バッファーのインデックスは 0 から作成されます。

[out] ppBuffer

IMFMediaBuffer インターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
E_INVALIDARG
 NULL ポインター引数、またはインデックスが範囲外です。

注釈

サンプルには、複数のバッファーが含まれている場合があります。 GetBufferByIndex メソッドを使用して、個々のバッファーを列挙します。

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

  • Windows XP Service Pack 2 (SP2) 以降。
  • 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

こちらもご覧ください

IMFSample

IMFSample::ConvertToContiguousBuffer

メディア サンプル