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 WDF_TRI_STATE-typée qui, si elle est définie sur WdfTrue, indique que l’appareil est désactivé. Pour plus d’informations sur le type de WDF_TRI_STATE, consultez la section Remarques suivante.

DontDisplayInUI

Valeur WDF_TRI_STATE-typée qui, si elle est définie sur WdfTrue, indique que l’appareil est masqué (non affiché) dans le 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 WDF_TRI_STATE-typée qui, si elle est définie sur WdfTrue, indique que l’appareil est présent mais a échoué.

NotDisableable

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

Removed

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

ResourcesChanged

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

AssignedToGuest

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

Remarques

Les membres de la structure utilisent le type WDF_TRI_STATE. La valeur de 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 NotDisableable et que le pilote de fonction de l’appareil spécifie WdfUseDefault, le framework 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.

Spécifications