structure WDF_DEVICE_STATE (wdfdevice.h)

[S’applique à KMDF et UMDF]

La structure WDF_DEVICE_STATE spécifie l’état Plug-and-Play d’un appareil.

Syntaxe

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;

Membres

Size

Taille, en octets, de cette structure.

Disabled

Valeur de type WDF_TRI_STATE qui, si elle est définie sur WdfTrue, indique que l’appareil est désactivé. Pour plus d’informations sur le type WDF_TRI_STATE , consultez la section Remarques suivante.

DontDisplayInUI

Valeur de type WDF_TRI_STATE qui, si elle est définie sur WdfTrue, indique que l’appareil est masqué (non affiché) dans Gestionnaire de périphériques. Pour plus d’informations, consultez Affichage des appareils masqués. (Après avoir défini ce membre sur WdfTrue, la modification de sa valeur n’a aucun effet.)

Failed

Valeur de type WDF_TRI_STATE qui, si elle est définie sur WdfTrue, indique que l’appareil est présent mais a échoué.

NotDisableable

Valeur de type WDF_TRI_STATE qui, si elle est définie sur WdfTrue, indique que l’appareil ne peut pas être désactivé.

Removed

Valeur de type WDF_TRI_STATE qui, si elle est définie sur WdfTrue, indique que l’appareil a été supprimé.

ResourcesChanged

Valeur de type WDF_TRI_STATE qui, si elle est définie sur WdfTrue, indique que les besoins en ressources de l’appareil ont changé.

AssignedToGuest

Valeur de type WDF_TRI_STATE qui, si elle est définie sur WdfTrue, indique que l’appareil se signale lui-même comme affecté à une partition invité.

Remarques

Les membres de structure utilisent le type WDF_TRI_STATE . La valeur WdfUseDefault indique que l’infrastructure utilisera la valeur fournie par un pilote inférieur dans la pile. Par exemple, si un pilote de bus spécifie WdfTrue pour NotDisable et que le pilote de fonction de l’appareil spécifie WdfUseDefault, l’infrastructure utilise WdfTrue pour l’état de l’appareil.

La structure WDF_DEVICE_STATE est utilisée comme paramètre pour WdfDeviceSetDeviceState et WdfDeviceGetDeviceState.

Pour initialiser une structure WDF_DEVICE_STATE , le pilote doit appeler WDF_DEVICE_STATE_INIT.

Pour plus d’informations sur les membres de la structure WDF_DEVICE_STATE , consultez PNP_DEVICE_STATE.

Configuration requise