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 を呼び出して新しい電源状態を判断する必要があります。

生体認証フレームワークは、任意のスレッドのコンテキストで、このアダプター エントリ ポイントを非同期的に呼び出します。 アダプターは、この呼び出しの処理を他の作業と同期する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winbio_adapter.h

こちらもご覧ください

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE