PoClearPowerRequest-Funktion (ntifs.h)

Die PoClearPowerRequest-Routine verringert 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 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

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
STATUS_NOT_SUPPORTED	Der Parameter Type wird 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 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, stellt der Power Manager das Standardverhalten für den angegebenen Energieanforderungstyp wieder her.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Zielplattform	Universell
Header	ntifs.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

POWER_REQUEST_TYPE

PoCreatePowerRequest

PoSetPowerRequest