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 更新汇总) 安装。

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfobjects.h (包括 Mfidl.h)
Library Mfuuid.lib

另请参阅

特性和属性

IMFAttributes

MF_ATTRIBUTE_TYPE