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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。
リターン コード | 説明 |
---|---|
|
関数が正常に実行されました。 |
|
要求されたオフセットまたは要求された長さが無効です。 |
注釈
ラッパー バッファーの最大サイズは、元のバッファー内の有効なデータのサイズに制限されます。 これは、元のバッファーの割り当てられたサイズよりも小さい場合があります。 有効なデータのサイズを設定するには、 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 |