POFXCALLBACKUPDATEPLATFORMIDLESTATE 回呼函式 (pepfx.h)

發行項
02/29/2024

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 已向 PoFx 註冊處理器的 PEP_DPM_REGISTER_DEVICE 通知期間，從 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 例程並未針對這個處理器實作。