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:

• EvtDevicePrepareHardware

• EvtDeviceReleaseHardware

• EvtDeviceD0Entry

• EvtDeviceD0EntryPostInterruptsEnabled

• EvtDeviceD0Exit

• EvtDeviceD0ExitPreInterruptsDisabled

• EvtDeviceSelfManagedIoInit

• EvtDeviceSelfManagedIoSuspend

• EvtDeviceSelfManagedIoRestart

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