PoFxRegisterCoreDevice 函数 (pep_x.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) 管理的硬件设备，例如计时器和中断控制器。这些设备提供操作系统所需的基本功能。由于核心系统资源和处理器之间的密切关系，这些资源的电源管理需要与处理器空闲状态管理进行协调。

应在 IRQL = PASSIVE_LEVEL 调用 PoFxRegisterCoreDevice 例程。