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)

Vedi anche

WDF_DEVICE_STATE_INIT