IMFAttributes::GetAllocatedBlob メソッド (mfobjects.h)
キーに関連付けられているバイト配列を取得します。 このメソッドは、配列のメモリを割り当てます。
構文
HRESULT GetAllocatedBlob(
[in] REFGUID guidKey,
[out] UINT8 **ppBuf,
[out] UINT32 *pcbSize
);
パラメーター
[in] guidKey
取得する値を識別する GUID。 属性の型は MF_ATTRIBUTE_BLOBする必要があります。
[out] ppBuf
キーが見つかり、値がバイト配列である場合、このパラメーターは配列のコピーを受け取ります。 呼び出し元は 、CoTaskMemFree を呼び出して、配列のメモリを解放する必要があります。
[out] pcbSize
配列のサイズをバイト単位で受け取ります。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
指定したキーが見つかりませんでした。 |
|
属性値はバイト配列ではありません。 |
注釈
バイト配列の値を呼び出し元によって割り当てられたバッファーにコピーするには、 IMFAttributes::GetBlob メソッドを使用します。
このインターフェイスは、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 |