PoClearPowerRequest-Funktion (wdm.h)
Die PoClearPowerRequest-Routine erhöht die Anzahl für den angegebenen Energieanforderungstyp.
Syntax
NTSTATUS PoClearPowerRequest(
[in, out] PVOID PowerRequest,
[in] POWER_REQUEST_TYPE Type
);
Parameter
[in, out] PowerRequest
Ein Zeiger auf ein Energieanforderungsobjekt, 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
PoClearPowerRequest gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Wenn der Aufruf fehlschlägt, sind folgende Fehlerrückgabecodes möglich:
| Rückgabecode | Beschreibung |
|---|---|
|
Parametertyp ist auf einen nicht unterstützten Wert festgelegt. |
Hinweise
Ein Treiber kann die PoSetPowerRequest-Routine aufrufen, um anzufordern, dass der Power Manager mehrere Typen 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 Power Manager verwaltet eine 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 erhöht die Anzahl um eins. Eine Nichtzeroanzahl gibt an, dass Anforderungen von einer oder mehreren Komponenten aktiv sind. Nachdem sich die Anzahl auf null verringert hat, stellt der Power Manager das Standardverhalten für den angegebenen Energieanforderungstyp wieder her.
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 |