iWMDMMetaData::QueryByIndex 方法 (mswmdm.h)
QueryByIndex 方法检索 index 指定的属性的值。
语法
HRESULT QueryByIndex(
[in] UINT iIndex,
[out] WCHAR **ppwszName,
[out] WMDM_TAG_DATATYPE *pType,
[out] BYTE **ppValue,
[out] UINT *pcbLength
);
参数
[in] iIndex
指定属性从零开始的索引的整数。 项数是通过 GetItemCount 调用获取的。
[out] ppwszName
属性的名称。 Windows Media 设备管理器分配此内存,调用方必须使用 CoTaskMemFree 释放它。
[out] pType
描述 ppValue 中返回的数据类型的WMDM_TAG_DATATYPE枚举值。
[out] ppValue
指向字节数组的指针的指针,如果方法成功,该字节数组接收值的内容。 此内存由 Windows Media 设备管理器分配,调用方必须使用 CoTaskMemFree 释放它。
[out] pcbLength
指向字节数组 ppValue 的大小(以字节为单位)的指针。 如果值为字符串,则包括终止字符。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |