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, umfassen mögliche Fehlerrücklaufcodes Folgendes:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_NOT_SUPPORTED | Der parameter Type wird auf einen nicht unterstützten Wert festgelegt. |
Bemerkungen
Ein Treiber kann die PoSetPowerRequest- Routine aufrufen, um anzufordern, dass der Power Manager mehrere Arten von Standardleistungsverhalten außer Kraft setzen, die als POWER_REQUEST_TYPE Enumerationswerte angegeben werden. Um das Standardverhalten wiederherzustellen, bricht der Treiber die Anforderung ab, indem die PoClearPowerRequest Routine aufgerufen wird.
Der Power 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 erhöht die Anzahl um eine. Eine Nichtzero-Anzahl gibt an, dass Anforderungen aus einer oder mehreren Komponenten aktiv sind. Nachdem die Anzahl auf 0 erhöht wurde, wird der Computer auf das Standardverhalten für den angegebenen Energieanforderungstyp zurückgesetzt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 7 |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL |