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

另請參閱

POWER_REQUEST_TYPE

PoCreatePowerRequest

PoSetPowerRequest