Interfaccia IDeviceSpecificProperty (devicetopology.h)

Articolo
08/23/2023

L'interfaccia IDeviceSpecificProperty consente di accedere al valore di controllo di un controllo hardware specifico del dispositivo. Un client ottiene un riferimento a un'interfaccia IDeviceSpecificProperty di una parte chiamando il metodo IPart::Activate con il parametro refiid impostato su REFIID IID_IDeviceSpecificProperty. La chiamata a IPart::Activate ha esito positivo solo se la parte supporta l'interfaccia IDeviceSpecificProperty . Una parte supporta questa interfaccia solo se il controllo hardware sottostante ha un valore di controllo specifico del dispositivo e il controllo non può essere adeguatamente rappresentato da qualsiasi altra interfaccia nell'API DeviceTopology.

In genere, una proprietà specifica del dispositivo è utile solo per un client che può dedurre il significato del valore della proprietà da informazioni quali il tipo di parte, il sottotipo di parte e il nome della parte. Il client può ottenere queste informazioni chiamando i metodi IPart::GetPartType, IPart::GetSubType e IPart::GetName .

La maggior parte dei driver dell'adattatore audio di Windows supporta il modello di driver Windows (WDM) e usa le proprietà di streaming del kernel (KS) per rappresentare i parametri del controllo hardware nelle sottounità (denominate nodi KS). L'interfaccia IDeviceSpecificProperty consente di accedere facilmente alla proprietà KSPROPERTY_AUDIO_DEV_SPECIFIC di una subunit con un valore GUID sottotipo di KSNODETYPE_DEV_SPECIFIC. Per ottenere il GUID del sottotipo di una subunit, chiamare il metodo IPart::GetSubType . Per altre informazioni sulle proprietà KS e sui tipi di nodo KS, vedere la documentazione di Windows DDK.

Ereditarietà

L'interfaccia IDeviceSpecificProperty eredita dall'interfaccia IUnknown . IDeviceSpecificProperty include anche questi tipi di membri:

Metodi

L'interfaccia IDeviceSpecificProperty include questi metodi.


IDeviceSpecificProperty::Get4BRange Il metodo Get4BRange ottiene l'intervallo a 4 byte del valore della proprietà specifica del dispositivo.
IDeviceSpecificProperty::GetType Il metodo GetType ottiene il tipo di dati del valore della proprietà specifica del dispositivo.
IDeviceSpecificProperty::GetValue Il metodo GetValue ottiene il valore corrente della proprietà specifica del dispositivo.
IDeviceSpecificProperty::SetValue Il metodo SetValue imposta il valore della proprietà specifica del dispositivo.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

Interfacce audio di base