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) |