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)

另请参阅

IKsPropertySet：：Set