POFXCALLBACKUPDATEPLATFORMIDLESTATE 回調函式 (pepfx.h)
UpdatePlatformIdleState 例程是由平臺延伸模組外掛程式 (PEP) 呼叫,以更新指定平臺閑置狀態的屬性。
語法
POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;
NTSTATUS Pofxcallbackupdateplatformidlestate(
[in] POHANDLE ProcessorHandle,
[in] ULONG PlatformState,
[in] PPEP_PLATFORM_IDLE_STATE_UPDATE Update
)
{...}
參數
[in] ProcessorHandle
POHANDLE 值,代表使用 Windows 電源管理架構 (PoFx) 註冊處理器(裝置)。 PEP 先前在 PEP_DPM_REGISTER_DEVICE 通知期間從 PoFx 收到此句柄,通知 PEP 已向 PoFx 註冊處理器。
[in] PlatformState
索引,識別要更新其屬性的平臺閑置狀態。 為了回應先前的 PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES 通知,PEP 指定了支援的平臺閑置狀態數目。 如果 PEP 指定的 N 平台閒置狀態,有效的平臺閒置狀態索引範圍從 0 到 N-1。 為了回應先前的 PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE 通知,PEP 指定了這個平臺閑置狀態的屬性。
[in] Update
PEP_PLATFORM_IDLE_STATE_UPDATE 結構的指標,其中包含平臺閑置狀態的更新屬性。
傳回值
UpdatePlatformIdleState 如果成功更新平臺閑置狀態的屬性,就會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。
傳回值 | 描述 |
---|---|
|
PEP_PLATFORM_IDLE_STATE_UPDATE 結構中的版本號碼不是支援的值。 |
|
UpdatePlatformIdleState 例程未針對此處理器實作。 |
言論
此例程是由 PoFx 實作,並由 PEP 呼叫。 PEP_KERNEL_INFORMATION_STRUCT_V3 結構的 UpdatePlatformIdleState 成員是 UpdatePlatformIdleState 例程的指標。
PEP 必須等到完成所有 PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE 通知之後,才能呼叫 UpdatePlatformIdleState 例程。
UpdatePlatformIdleState 例程必須在 IRQL = PASSIVE_LEVEL呼叫。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 10 開始支援。 |
目標平臺 | 窗戶 |
標頭 | pepfx.h (include Pep_x.h) |
IRQL | PASSIVE_LEVEL |
另請參閱
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE