poClearPowerRequest 函式 (ntifs.h)
PoClearPowerRequest 例程會遞減指定電源要求類型的計數。
語法
NTSTATUS PoClearPowerRequest(
[in, out] PVOID PowerRequest,
[in] POWER_REQUEST_TYPE Type
);
參數
[in, out] PowerRequest
PoCreatePowerRequest 例程所建立之電源要求對象的指標。
[in] Type
電源要求的型別。 將此參數設定為下列 POWER_REQUEST_TYPE 列舉值：
- PowerRequestSystemRequired
傳回值
如果呼叫成功，PoClearPowerRequest 會傳回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 |