WdfDeviceGetDevicePowerState-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Anmerkung
Diese Funktion ist nur für die interne Verwendung von Microsoft vorgesehen.
Die WdfDeviceGetDevicePowerState- Methode gibt den aktuellen Zustand des Energiezustandsautomaten des Frameworks für ein angegebenes Gerät zurück.
Syntax
WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
[in] WDFDEVICE Device
);
Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt.
Rückgabewert
WdfDeviceGetDevicePowerState gibt einen WDF_DEVICE_POWER_STATE-typed-Enumerator zurück, der den aktuellen Zustand des Energiezustandsautomaten 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 WdfDeviceGetDevicePowerState--Methode gibt nur dann einen aussagekräftigen Wert zurück, wenn sie aus den folgenden Rückruffunktionen aufgerufen wird:
Beispiele
Im folgenden Codebeispiel wird der aktuelle Zustand des Energiezustandsautomaten des Frameworks für ein angegebenes Gerät erhalten.
WDF_DEVICE_POWER_STATE state;
state = WdfDeviceGetDevicePowerState(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) |