WdfDeviceGetDevicePowerPolicyState-Funktion (wdfdevice.h)

[Gilt nur für KMDF]

Hinweis

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

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

Syntax

WDF_DEVICE_POWER_POLICY_STATE WdfDeviceGetDevicePowerPolicyState(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

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

Rückgabewert

WdfDeviceGetDevicePowerPolicyState gibt einen WDF_DEVICE_POWER_POLICY_STATE typisierten Enumerator zurück, der den aktuellen Zustand des Energierichtlinienzustandscomputers 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 WdfDeviceGetDevicePowerPolicyState-Methode gibt nur dann einen aussagekräftigen Wert zurück, wenn er innerhalb der Rückruffunktionen aufgerufen wird, die der Treiber beim Aufrufen von WdfDeviceInitSetPowerPolicyEventCallbacks registriert.

Beispiele

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

WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;

devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(Device);

Anforderungen

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

Weitere Informationen

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerState