Funzione WdfDeviceSetDeviceState (wdfdevice.h)
[Si applica a KMDF e UMDF]
Il metodo WdfDeviceSetDeviceState imposta lo stato del dispositivo per un dispositivo specificato.
Sintassi
void WdfDeviceSetDeviceState(
[in] WDFDEVICE Device,
[in] PWDF_DEVICE_STATE DeviceState
);
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
[in] DeviceState
Puntatore a una struttura di WDF_DEVICE_STATE allocata dal driver che contiene le informazioni sullo stato del dispositivo.
Valore restituito
nessuno
Osservazioni
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Quando un driver chiama WdfDeviceSetDeviceState, il framework notifica alla gestione Plug and Play (PnP) che lo stato del dispositivo è cambiato.
Esempio
L'esempio di codice seguente informa la gestione PnP che un dispositivo specificato è disabilitato.
WDF_DEVICE_STATE deviceState;
WDF_DEVICE_STATE_INIT (&deviceState);
deviceState.Disabled = WdfTrue;
WdfDeviceSetDeviceState (
Device,
&deviceState
);
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 | <= DISPATCH_LEVEL |
Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |