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)

另请参阅

IKsPropertySet：：Set