PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN回调函数 (winbio_adapter.h)

  • 项目

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

语法

PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN PibioStorageNotifyPowerChangeFn;

HRESULT PibioStorageNotifyPowerChangeFn(
  [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 值。

返回代码 说明
E_POINTER
 Pipeline 参数为 NULL。
E_INVALIDARG
 PowerEventType 参数不是表中列出的值之一。

注解

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

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

要求

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

另请参阅

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE