共用方式為

PoSetPowerRequest 函式 (wdm.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
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另請參閱

POWER_REQUEST_TYPE

PoClearPowerRequest

PoCreatePowerRequest