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 with 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 2005。

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfobjects.h (包含 Mfidl.h)
程式庫 Mfuuid.lib

另請參閱

屬性和屬性

IMFAttributes

MF_ATTRIBUTE_TYPE