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 指定 NULLDataLength指定零。 Get 方法以 BytesReturned返回所需的缓冲区大小。

警告

头文件 ksproxy.hdsound.h 定义 IKsPropertySet 接口的类似但不兼容的版本。 需要 KS 代理模块的应用程序应使用 ksproxy.h中定义的版本。 如果应用程序必须同时包含 ksproxy.hdsound.h,则编译器首先扫描的头文件是编译器使用 IKsPropertySet 的定义。

要求

要求 价值
目标平台 桌面
标头 ksproxy.h (包括 Ksproxy.h、Dsound.h)

另请参阅

IKsPropertySet::Set