Freigeben über


PoSetPowerRequest-Funktion (ntifs.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) 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

PoClearPowerRequest

PoCreatePowerRequest