共用方式為


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。 可能的錯誤傳回值包括下列狀態代碼。

傳回值 描述
STATUS_NOT_SUPPORTED
PEP_PLATFORM_IDLE_STATE_UPDATE 結構中的版本號碼不是支援的值。
STATUS_NOT_IMPLEMENTED
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_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE