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
STATUS_NOT_SUPPORTED	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

Weitere Informationen

POWER_REQUEST_TYPE

PoClearPowerRequest

PoCreatePowerRequest