IMDSPDevice3::GetProperty 方法 (mswmdm.h)

GetProperty 方法检索特定的设备属性。

语法

HRESULT GetProperty(
  [in]  LPCWSTR     pwszPropName,
  [out] PROPVARIANT *pValue
);

参数

[in] pwszPropName

从设备检索的属性的名称。

[out] pValue

属性的返回值。

返回值

该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:

  • 标准 COM 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

注解

pValue 指向的变体设置为空 PROPVARIANT,即其 VT 设置为VT_EMPTY。

服务提供程序应将此变体设置为 pwszPropName 属性的相应属性值。

如果 pwszPropNameg_wszWMDMSupportedDeviceProperties,则服务提供商应返回受支持设备属性的数组。 在这种情况下,应VT_BSTR变量的 VT |VT_ARRAY。

有关标准设备属性名称的列表,请参阅 元数据常量

此方法类似于用于存储的 IMDSPStorage3::GetMetadataIMDSPStorage4::GetSpecifiedMetadata 方法,但此方法一次只能获取一个属性。

要求

要求
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

IMDSPDevice3 接口

IMDSPDevice3::SetProperty

IMDSPStorage3::GetMetadata

IMDSPStorage4::GetSpecifiedMetadata

元数据常量