Freigeben über


WdfDeviceGetDevicePowerState-Funktion (wdfdevice.h)

[Gilt nur für KMDF]

Hinweis

Diese Funktion ist nur für die interne Verwendung von Microsoft vorgesehen.

Die WdfDeviceGetDevicePowerState-Methode gibt den aktuellen Zustand des Energiezustandscomputers des Frameworks für ein angegebenes Gerät zurück.

Syntax

WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

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

Rückgabewert

WdfDeviceGetDevicePowerState gibt einen WDF_DEVICE_POWER_STATE typisierten Enumerator zurück, der den aktuellen Zustand des Energiezustandscomputers des Frameworks für das angegebene Gerät identifiziert.

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

Hinweise

Weitere Informationen zu den Zustandscomputern des Frameworks finden Sie unter Zustandscomputer im Framework.

Die WdfDeviceGetDevicePowerState-Methode gibt nur dann einen aussagekräftigen Wert zurück, wenn sie aus den folgenden Rückruffunktionen aufgerufen wird:

Beispiele

Im folgenden Codebeispiel wird der aktuelle Zustand des Energiezustandscomputers des Frameworks für ein angegebenes Gerät abgerufen.

WDF_DEVICE_POWER_STATE state;

state = WdfDeviceGetDevicePowerState(Device);

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerPolicyState