Interfaccia IDeviceSpecificProperty (devicetopology.h)
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 |