共用方式為

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 值。

傳回碼 Description
E_POINTER
 Pipeline 自變數為 NULL
E_INVALIDARG
 PowerEventType 自變數不是列出的其中一個值。

備註

收到 PBT_APMPOWERSTATUSCHANGE 事件時，配接器應該呼叫 Microsoft Win32GetSystemPowerStatus API 來判斷新的電源狀態。

生物特徵辨識架構會在任意線程的內容中，以異步方式呼叫此配接器進入點。 配接器必須負責將此呼叫的處理與可能執行的任何其他工作同步處理。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbio_adapter.h