PoSetPowerRequest-Funktion (wdm.h)
Die PoSetPowerRequest-Routine erhöht die Anzahl für den angegebenen Energieanforderungstyp.
Syntax
NTSTATUS PoSetPowerRequest(
[in, out] PVOID PowerRequest,
[in] POWER_REQUEST_TYPE Type
);
Parameter
[in, out] PowerRequest
Ein Zeiger auf ein Power Request-Objekt, das von der PoCreatePowerRequest-Routine erstellt wurde.
[in] Type
Der Typ der Energieanforderung. Legen Sie diesen Parameter auf den folgenden POWER_REQUEST_TYPE-Enumerationswert fest:
- PowerRequestSystemRequired
Rückgabewert
PoSetPowerRequest gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Wenn der Aufruf fehlschlägt, sind folgende Fehlerrückgabecodes möglich:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Type-Parameter wird auf einen nicht unterstützten Wert festgelegt. |
Hinweise
Ein Treiber kann die PoSetPowerRequest-Routine aufrufen, um anzufordern, dass der Power Manager mehrere Arten des Standardleistungsverhaltens außer Kraft setzt, die als POWER_REQUEST_TYPE Enumerationswerte angegeben werden. Um das Standardverhalten wiederherzustellen, bricht der Treiber die Anforderung ab, indem er die PoClearPowerRequest-Routine aufruft.
Der Energie-Manager verwaltet die Anzahl der aktiven Anforderungen für jeden Energieanforderungstyp. Die PoSetPowerRequest-Routine erhöht die Anzahl für den angegebenen Energieanforderungstyp um eins. Die PoClearPowerRequest-Routine verringert die Anzahl um eins. Eine Anzahl ungleich null gibt an, dass Anforderungen von einer oder mehreren Komponenten aktiv sind. Nachdem die Anzahl auf 0 (null) verringert wurde, wird das Standardverhalten des angegebenen Energieanforderungstyps auf dem Computer wiederhergestellt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 7. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |