WdfDeviceSetDeviceState-Funktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WdfDeviceSetDeviceState-Methode legt den Gerätestatus für ein angegebenes Gerät fest.

Syntax

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

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] DeviceState

Ein Zeiger auf eine vom Treiber zugewiesene WDF_DEVICE_STATE Struktur, die die Zustandsinformationen des Geräts enthält.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Wenn ein Treiber WdfDeviceSetDeviceState aufruft, benachrichtigt das Framework den Plug & Play-Manager (PnP), dass sich der Gerätestatus geändert hat.

Beispiele

Im folgenden Codebeispiel wird der PnP-Manager darüber informiert, dass ein angegebenes Gerät deaktiviert ist.

WDF_DEVICE_STATE    deviceState;

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

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_DEVICE_STATE_INIT