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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
メソッドが成功しました。
MF_E_ATTRIBUTENOTFOUND
指定したキーが見つかりませんでした。
MF_E_INVALIDTYPE
属性値はバイト配列ではありません。

注釈

バイト配列の値を呼び出し元によって割り当てられたバッファーにコピーするには、 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

こちらもご覧ください

属性とプロパティ

IMFAttributes

MF_ATTRIBUTE_TYPE