Funzione WdfDeviceSetInterfaceState (wdfdevice.h)
[Si applica a KMDF e UMDF]
Il metodo WdfDeviceSetInterfaceState abilita o disabilita un'interfaccia dispositivo per un dispositivo specificato.
Nota
Il driver deve chiamare questa funzione solo dopo l'avvio del dispositivo. Per modificare lo stato dell'interfaccia dall'aggiunta del dispositivo, chiamare invece WdfDeviceSetDeviceInterfaceStateEx .
Sintassi
void WdfDeviceSetDeviceInterfaceState(
[in] WDFDEVICE Device,
[in] const GUID *InterfaceClassGUID,
[in, optional] PCUNICODE_STRING ReferenceString,
[in] BOOLEAN IsInterfaceEnabled
);
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
[in] InterfaceClassGUID
Puntatore a un GUID che identifica la classe dell'interfaccia del dispositivo.
[in, optional] ReferenceString
Puntatore a una struttura UNICODE_STRING che descrive una stringa di riferimento per l'interfaccia del dispositivo. Questo parametro è facoltativo e può essere NULL.
[in] IsInterfaceEnabled
Valore booleano che, se TRUE, abilita l'istanza dell'interfaccia del dispositivo specificata o, se FALSE, la disabilita.
Valore restituito
nessuno
Osservazioni
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Per altre informazioni sulle interfacce del dispositivo e sul metodo WdfDeviceSetDeviceInterfaceState , vedere Uso di interfacce dispositivo.
Esempio
Nell'esempio di codice seguente viene disabilitata l'interfaccia della porta COM di un driver.
WdfDeviceSetDeviceInterfaceState (
Device,
(LPGUID) &GUID_DEVINTERFACE_COMPORT,
NULL,
FALSE
);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfdevice.h (includere Wdf.h) |
| Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Vedi anche
WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx