IKsPropertySet::Get 方法 (ksproxy.h)
Get 方法检索由属性集 GUID 和属性标识符标识的属性。
语法
HRESULT Get(
[in] REFGUID PropSet,
[in] ULONG Id,
[in] LPVOID InstanceData,
[in] ULONG InstanceLength,
[out] LPVOID PropertyData,
[in] ULONG DataLength,
[out] ULONG *BytesReturned
);
参数
[in] PropSet
标识属性集的 GUID。
[in] Id
属性集中属性的标识符。
[in] InstanceData
指向属性的实例数据的指针。
[in] InstanceLength
InstanceData的缓冲区的大小(以字节为单位)。
[out] PropertyData
指向接收属性值的缓冲区的指针。
[in] DataLength
PropertyData处缓冲区的大小(以字节为单位)。
[out] BytesReturned
指向一个变量的指针,该变量接收 获取 存储在缓冲区中的数据的大小(以字节为单位)PropertyData。
返回值
如果成功,则返回 NOERROR;否则,返回错误代码。
言论
若要检索属性,请分配一个缓冲区,该缓冲区 获取 填充该属性。 若要确定必要的缓冲区大小,请为 PropertyData 指定 NULL,DataLength指定零。 Get 方法以 BytesReturned返回所需的缓冲区大小。
警告
头文件 ksproxy.h 和 dsound.h 定义 IKsPropertySet 接口的类似但不兼容的版本。 需要 KS 代理模块的应用程序应使用 ksproxy.h中定义的版本。 如果应用程序必须同时包含 ksproxy.h 和 dsound.h,则编译器首先扫描的头文件是编译器使用 IKsPropertySet 的定义。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | ksproxy.h (包括 Ksproxy.h、Dsound.h) |