MFCreateMediaBufferWrapper 関数 (mfapi.h)

既存のメディア バッファーをラップするメディア バッファーを作成します。 新しいメディア バッファーは、元のメディア バッファーと同じメモリ、またはメモリの先頭からのオフセットを指します。

構文

HRESULT MFCreateMediaBufferWrapper(
  [in]  IMFMediaBuffer *pBuffer,
  [in]  DWORD          cbOffset,
  [in]  DWORD          dwLength,
  [out] IMFMediaBuffer **ppBuffer
);

パラメーター

[in] pBuffer

元のメディア バッファーの IMFMediaBuffer インターフェイスへのポインター。

[in] cbOffset

元のバッファーの先頭からのオフセット (バイト単位) としての新しいバッファーの開始。

[in] dwLength

新しいバッファーのサイズ。 cbOffset + dwLength の値は、元のバッファーの有効なデータのサイズ以下である必要があります。 (有効なデータのサイズは、 IMFMediaBuffer::GetCurrentLength メソッドによって返されます)。

[out] ppBuffer

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

戻り値

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

リターン コード	説明
S_OK	関数が正常に実行されました。
E_INVALIDARG	要求されたオフセットまたは要求された長さが無効です。

注釈

ラッパー バッファーの最大サイズは、元のバッファー内の有効なデータのサイズに制限されます。 これは、元のバッファーの割り当てられたサイズよりも小さい場合があります。 有効なデータのサイズを設定するには、 IMFMediaBuffer::SetCurrentLength を呼び出します。

この機能は、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
ヘッダー	mfapi.h
Library	Mfplat.lib
[DLL]	Mfplat.dll

こちらもご覧ください

メディア バッファー

メディア ファンデーション機能