WdfDeviceSetDeviceState, fonction (wdfdevice.h)

  • Article

[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 pour un objet d’appareil d’infrastructure.

[in] DeviceState

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

Valeur de retour

None

Remarques

Un bogue case activée 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
                         );

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête wdfdevice.h (inclure Wdf.h)
Bibliothèque Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WDF_DEVICE_STATE_INIT