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