通过

PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN回调函数 (winbio_adapter.h)

  • 项目

当计算机准备好进入低功耗状态或计算机已从低功耗状态唤醒时，由 Windows 生物识别框架调用。 此函数的目的是使适配器能够响应计算机电源状态中的转换。

语法

PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN PibioEngineNotifyPowerChangeFn;

HRESULT PibioEngineNotifyPowerChangeFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      ULONG PowerEventType
)
{...}

参数

[in, out] Pipeline

指向与执行操作的生物识别单元关联的 WINBIO_PIPELINE 结构的指针。

[in] PowerEventType

指示更改的性质。 可以为下列值之一：

  • PBT_APMSUSPEND

系统正在进入低功耗状态。

  • PBT_APMRESUMEAUTOMATIC

系统正在从低功耗状态返回。

  • PBT_APMPOWERSTATUSCHANGE

系统电源的状态正在更改 (例如，系统已从电池切换到线路电源，或者电池) 变低。

返回值

如果函数成功，则返回 S_OK。 如果函数失败，它将返回一个 指示错误的 HRESULT 值。 可能的值包括（但并不限于）下表中的项。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

注解

收到 PBT_APMPOWERSTATUSCHANGE 事件时，适配器应调用 Microsoft Win32GetSystemPowerStatus API 来确定新的电源状态。

生物识别框架在任意线程的上下文中异步调用此适配器入口点。 适配器负责将此调用的处理与其可能正在执行的任何其他工作同步。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 winbio_adapter.h

另请参阅

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE