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

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

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

Требования

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

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

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE