PoSetPowerRequest 函式 (ntifs.h)
PoSetPowerRequest 例程會遞增指定電源要求類型的計數。
語法
NTSTATUS PoSetPowerRequest(
[in, out] PVOID PowerRequest,
[in] POWER_REQUEST_TYPE Type
);
參數
[in, out] PowerRequest
PoCreatePowerRequest 例程所建立之電源要求對象的指標。
[in] Type
電源要求的類型。 將此參數設定為下列 POWER_REQUEST_TYPE 列舉值：
- PowerRequestSystemRequired
傳回值
如果呼叫成功，PoSetPowerRequest 會傳回STATUS_SUCCESS。 如果呼叫失敗，可能的錯誤傳回碼包括下列各項：
| 傳回碼 | Description |
|---|---|
| STATUS_NOT_SUPPORTED | Type 參數會設定為不支援的值。 |
備註
驅動程式可以呼叫 PoSetPowerRequest 例程，要求 電源管理員 覆寫數種類型的預設電源行為，這些類型會指定為 POWER_REQUEST_TYPE 列舉值。 若要還原預設行為，驅動程式會呼叫 PoClearPowerRequest 例程來取消要求。
電源管理員會維護每個電源要求類型的使用中要求計數。 PoSetPowerRequest 例程會將指定電源要求類型的計數遞增一。 PoClearPowerRequest 例程會將計數遞減一。 非零計數表示來自一或多個元件的要求為作用中。 在計數遞減為零之後，計算機會還原為指定電源要求類型的默認行為。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 |
| 目標平台 | Universal |
| 標頭 | ntifs.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |