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를 호출하여 새 전원 상태 결정해야 합니다.

생체 인식 프레임워크는 임의 스레드의 컨텍스트에서 이 어댑터 진입점을 비동기적으로 호출합니다. 이 호출의 처리를 수행할 수 있는 다른 작업과 동기화하는 것은 어댑터의 책임입니다.

요구 사항

추가 정보

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE