Freigeben über


IDeviceSpecificProperty-Schnittstelle (devicetopology.h)

Die IDeviceSpecificProperty-Schnittstelle bietet Zugriff auf den Steuerungswert eines gerätespezifischen Hardwaresteuerelements. Ein Client ruft einen Verweis auf eine IDeviceSpecificProperty-Schnittstelle eines Teils ab, indem er die IPart::Activate-Methode aufruft, deren Parameter refiid auf REFIID IID_IDeviceSpecificProperty festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn der Teil die IDeviceSpecificProperty-Schnittstelle unterstützt. Ein Teil unterstützt diese Schnittstelle nur, wenn das zugrunde liegende Hardwaresteuerelement über einen gerätespezifischen Steuerungswert verfügt und das Steuerelement von keiner anderen Schnittstelle in der DeviceTopology-API angemessen dargestellt werden kann.

In der Regel ist eine gerätespezifische Eigenschaft nur für einen Client nützlich, der die Bedeutung des Eigenschaftswerts aus Informationen wie dem Teiltyp, dem Teiluntertyp und dem Teilenamen ableiten kann. Der Client kann diese Informationen abrufen, indem er die Methoden IPart::GetPartType, IPart::GetSubType und IPart::GetName aufruft.

Die meisten Windows-Audioadaptertreiber unterstützen das Windows-Treibermodell (Windows Driver Model, WDM) und verwenden Kernelstreamingeigenschaften (KS), um die Hardwaresteuerungsparameter in Untereinheiten (als KS-Knoten bezeichnet) darzustellen. Die IDeviceSpecificProperty-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_DEV_SPECIFIC-Eigenschaft einer Untereinheit mit dem GUID-Untertypwert KSNODETYPE_DEV_SPECIFIC. Um die Untertyp-GUID einer Untereinheit abzurufen, rufen Sie die IPart::GetSubType-Methode auf. Weitere Informationen zu KS-Eigenschaften und KS-Knotentypen finden Sie in der Dokumentation zu Windows DDK.

Vererbung

Die IDeviceSpecificProperty-Schnittstelle erbt von der IUnknown-Schnittstelle . IDeviceSpecificProperty verfügt auch über folgende Membertypen:

Methoden

Die IDeviceSpecificProperty-Schnittstelle verfügt über diese Methoden.

 
IDeviceSpecificProperty::Get4BRange

Die Get4BRange-Methode ruft den 4-Byte-Bereich des gerätespezifischen Eigenschaftswerts ab.
IDeviceSpecificProperty::GetType

Die GetType-Methode ruft den Datentyp des gerätespezifischen Eigenschaftswerts ab.
IDeviceSpecificProperty::GetValue

Die GetValue-Methode ruft den aktuellen Wert der gerätespezifischen Eigenschaft ab.
IDeviceSpecificProperty::SetValue

Die SetValue-Methode legt den Wert der gerätespezifischen Eigenschaft fest.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

Kernaudioschnittstellen

DeviceTopology-API

IPart::Activate

IPart::GetName

IPart::GetPartType

IPart::GetSubType