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