IDeviceSpecificProperty 接口 (devicetopology.h)

IDeviceSpecificProperty 接口提供对设备特定硬件控件的控制值的访问权限。 客户端通过调用 IPart::Activate 方法获取对部件的 IDeviceSpecificProperty 接口的引用,并将参数 refiid 设置为 REFIID IID_IDeviceSpecificProperty。 仅当部件支持 IDeviceSpecificProperty 接口时,对 IPart::Activate 的调用才会成功。 仅当基础硬件控件具有特定于设备的控件值,并且该控件不能由 DeviceTopology API 中的任何其他接口充分表示时,部件才支持此接口。

通常,特定于设备的属性仅对可以从部件类型、部件子类型和部件名称等信息推断属性值含义的客户端有用。 客户端可以通过调用 IPart::GetPartTypeIPart::GetSubTypeIPart::GetName 方法获取此信息。

大多数 Windows 音频适配器驱动程序支持 Windows 驱动程序模型 (WDM) ,并使用内核流式处理 (KS) 属性来表示子单元中的硬件控制参数, (称为 KS 节点) 。 IDeviceSpecificProperty 接口提供对子类型 GUID 值为 KSNODETYPE_DEV_SPECIFIC 的子单元的 KSPROPERTY_AUDIO_DEV_SPECIFIC 属性的便捷访问。 若要获取子单元的子类型 GUID,请调用 IPart::GetSubType 方法。 有关 KS 属性和 KS 节点类型的详细信息,请参阅 Windows DDK 文档。

继承

IDeviceSpecificProperty 接口继承自 IUnknown 接口。 IDeviceSpecificProperty 还具有以下类型的成员:

方法

IDeviceSpecificProperty 接口包含以下方法。

 
IDeviceSpecificProperty::Get4BRange

Get4BRange 方法获取特定于设备的属性值的 4 字节范围。
IDeviceSpecificProperty::GetType

GetType 方法获取特定于设备的属性值的数据类型。
IDeviceSpecificProperty::GetValue

GetValue 方法获取特定于设备的属性的当前值。
IDeviceSpecificProperty::SetValue

SetValue 方法设置特定于设备的属性的值。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

核心音频接口

DeviceTopology API

IPart::Activate

IPart::GetName

IPart::GetPartType

IPart::GetSubType