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