WdfDeviceGetDevicePowerState-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Hinweis
Diese Funktion ist nur für die interne Verwendung von Microsoft vorgesehen.
Die WdfDeviceGetDevicePowerState-Methode gibt den aktuellen Zustand des Energiezustandscomputers des Frameworks für ein angegebenes Gerät zurück.
Syntax
WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
[in] WDFDEVICE Device
);
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
Rückgabewert
WdfDeviceGetDevicePowerState gibt einen WDF_DEVICE_POWER_STATE typisierten Enumerator zurück, der den aktuellen Zustand des Energiezustandscomputers 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 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 Energiezustandscomputers des Frameworks für ein angegebenes Gerät abgerufen.
WDF_DEVICE_POWER_STATE state;
state = WdfDeviceGetDevicePowerState(Device);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |