PoFxRegisterCoreDevice 函式 (pepfx.h)

PoFxRegisterCoreDevice 例程會向 Windows 電源管理架構註冊新的核心系統資源， (PoFx) 。

語法

NTSTATUS PoFxRegisterCoreDevice(
  [in]  PCUNICODE_STRING   Id,
  [in]  PPO_FX_CORE_DEVICE Device,
  [out] POHANDLE           *Handle
);

[in] Id

可唯一識別核心系統資源的字串。這個成員是包含裝置識別字串之UNICODE_STRING結構的指標。

[in] Device

描述核心系統資源電源特性之PO_FX_CORE_DEVICE 結構的指標。

[out] Handle

例程寫入 POHANDLE 值之位置的指標。此句柄代表向PoFx註冊核心系統資源。

如果呼叫成功註冊 PEP，PoFxRegisterCoreDevice 會傳回STATUS_SUCCESS。可能的錯誤傳回值包括下列狀態代碼。

傳回值	描述
STATUS_INVALID_PARAMETER	此裝置的元件計數為零，或 PO_FX_CORE_DEVICE 結構包含無效的版本號碼，或此結構的 ComponentCriticalTransitionCallback 成員包含無效的函式指標。
STATUS_INSUFFICIENT_RESOURCES	無法配置完成要求註冊所需的資源。

此例程會註冊核心系統資源，讓此資源可由PoFx管理。

核心系統資源是由 Windows 硬體抽象層所管理的硬體裝置，例如定時器和中斷控制器， (HAL) 。這些裝置提供操作系統所需的基本功能。由於核心系統資源和處理器之間的緊密關聯性，這些資源的電源管理必須與處理器閑置狀態管理協調。

PoFxRegisterCoreDevice 例程應在 IRQL = PASSIVE_LEVEL呼叫。