Поделиться через

функция обратного вызова 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 адаптер должен вызвать APIGetSystemPowerStatus Microsoft Win32, чтобы определить новое состояние питания.

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

Требования

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

См. также раздел

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE