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 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 |