WdfDeviceSetDeviceState, fonction (wdfdevice.h)

[S’applique à KMDF et UMDF]

La méthode WdfDeviceSetDeviceState définit l’état de l’appareil pour un appareil spécifié.

Syntaxe

VOID WdfDeviceSetDeviceState(
  [in] WDFDEVICE         Device,
  [in] PWDF_DEVICE_STATE DeviceState
);

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] DeviceState

Pointeur vers une structure WDF_DEVICE_STATE allouée par le pilote qui contient les informations d’état de l’appareil.

Valeur de retour

Aucun

Remarques

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Lorsqu’un pilote appelle WdfDeviceSetDeviceState, l’infrastructure informe le gestionnaire Plug-and-Play (PnP) que l’état de l’appareil a changé.

Exemples

L’exemple de code suivant informe le gestionnaire PnP qu’un appareil spécifié est désactivé.

WDF_DEVICE_STATE    deviceState;

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

Exigences

Voir aussi

WDF_DEVICE_STATE_INIT