Share via

функция обратного вызова PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN (winbio_adapter.h)

  • Статья

Вызывается биометрической платформой Windows, когда система готова перейти в состояние с низким энергопотреблением или когда система была проснулась из состояния с низким энергопотреблением. Эта функция предназначена для того, чтобы позволить адаптеру реагировать на переходы в состоянии питания компьютера.

Синтаксис

PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN PibioSensorNotifyPowerChangeFn;

HRESULT PibioSensorNotifyPowerChangeFn(
  [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 адаптер должен вызвать APIGetSystemPowerStatus Microsoft Win32, чтобы определить новое состояние питания.

Биометрическая платформа вызывает эту точку входа адаптера асинхронно в контексте произвольного потока. Адаптер несет ответственность за синхронизацию обработки этого вызова с любой другой работой, которую он может выполнять.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header winbio_adapter.h