Freigeben über


WdfDeviceGetDevicePowerPolicyState-Funktion (wdfdevice.h)

[Gilt nur für KMDF]

Anmerkung

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 zu einem Framework-Geräteobjekt.

Rückgabewert

WdfDeviceGetDevicePowerPolicyState gibt einen WDF_DEVICE_POWER_POLICY_STATE-typed-Enumerator zurück, der den aktuellen Zustand des Energierichtlinienzustandsautomaten des Frameworks für das angegebene Gerät identifiziert.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

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

Die WdfDeviceGetDevicePowerPolicyState Methode gibt einen sinnvollen Wert nur zurück, wenn sie innerhalb der Rückruffunktionen aufgerufen wird, die der Treiber registriert, wenn er WdfDeviceInitSetPowerPolicyEventCallbacksaufruft.

Beispiele

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

WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;

devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(Device);

Anforderungen

Anforderung Wert
Zielplattform- Universal
Minimale KMDF-Version 1.0
Header- wdfdevice.h (einschließen Wdf.h)
Library Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL- <= DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WdfDevStateNormalize-

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerState