Funzione WdfDeviceSetDeviceState (wdfdevice.h)

Articolo
02/07/2025

[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

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Quando un driver chiama WdfDeviceSetDeviceState, il framework notifica al gestore Plug and Play (PnP) che lo stato del dispositivo è cambiato.

Esempi

L'esempio di codice seguente informa il gestore PnP che un dispositivo specificato è disabilitato.

WDF_DEVICE_STATE    deviceState;

WDF_DEVICE_STATE_INIT (&deviceState);
deviceState.Disabled = WdfTrue;
WdfDeviceSetDeviceState (
                         Device,
                         &deviceState
                         );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WDF_DEVICE_STATE_INIT

Condividi tramite