WDF_DEVICE_STATE struttura (wdfdevice.h)

  • Articolo

[Si applica a KMDF e UMDF]

La struttura WDF_DEVICE_STATE specifica lo stato di Plug and Play di un dispositivo.

Sintassi

typedef struct _WDF_DEVICE_STATE {
  ULONG         Size;
  WDF_TRI_STATE Disabled;
  WDF_TRI_STATE DontDisplayInUI;
  WDF_TRI_STATE Failed;
  WDF_TRI_STATE NotDisableable;
  WDF_TRI_STATE Removed;
  WDF_TRI_STATE ResourcesChanged;
  WDF_TRI_STATE AssignedToGuest;
} WDF_DEVICE_STATE, *PWDF_DEVICE_STATE;

Members

Size

Dimensione, in byte, della struttura.

Disabled

Valore WDF_TRI_STATE tipizzato che, se impostato su WdfTrue, indica che il dispositivo è disabilitato. Per altre informazioni sul tipo di WDF_TRI_STATE , vedere la sezione Osservazioni seguenti.

DontDisplayInUI

Valore WDF_TRI_STATE tipizzato che, se impostato su WdfTrue, indica che il dispositivo è nascosto (non visualizzato) in Gestione dispositivi. Per altre informazioni, vedere Visualizzazione di dispositivi nascosti. Dopo aver impostato questo membro su WdfTrue, la modifica del valore non ha alcun effetto.

Failed

Valore WDF_TRI_STATE tipizzato che, se impostato su WdfTrue, indica che il dispositivo è presente ma non è riuscito.

NotDisableable

Valore WDF_TRI_STATE tipizzato che, se impostato su WdfTrue, indica che il dispositivo non può essere disabilitato.

Removed

Valore WDF_TRI_STATE tipizzato che, se impostato su WdfTrue, indica che il dispositivo è stato rimosso.

ResourcesChanged

Valore WDF_TRI_STATE tipizzato che, se impostato su WdfTrue, indica che i requisiti delle risorse del dispositivo sono stati modificati.

AssignedToGuest

Valore WDF_TRI_STATE tipizzato che, se impostato su WdfTrue, indica che il dispositivo viene segnalato come assegnato a una partizione guest.

Commenti

I membri della struttura usano il tipo di WDF_TRI_STATE . Un valore di WdfUseDefault indica che il framework userà il valore fornito da un driver inferiore nello stack. Ad esempio, se un driver del bus specifica WdfTrue per NotDisable e il driver di funzione del dispositivo specifica WdfUseDefault, il framework usa WdfTrue per lo stato del dispositivo.

La struttura WDF_DEVICE_STATE viene usata come parametro per WdfDeviceSetDeviceState e WdfDeviceGetDeviceState.

Per inizializzare una struttura WDF_DEVICE_STATE , il driver deve chiamare WDF_DEVICE_STATE_INIT.

Per altre informazioni sui membri della struttura WDF_DEVICE_STATE , vedere PNP_DEVICE_STATE.

Requisiti

Requisito Valore
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfdevice.h (includere Wdf.h)