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
指向变量的指针,该变量接收 Get 存储在 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) |