WdfDeviceSetDeviceState, fonction (wdfdevice.h)

Article
02/27/2024

[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

Partager via