コールバック関数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 値」を参照してください。

リターン コード 説明
E_POINTER
 Pipeline 引数が NULL でした
E_INVALIDARG
 PowerEventType 引数は、一覧表示されている値の 1 つではありません。

注釈

PBT_APMPOWERSTATUSCHANGE イベントを受信すると、アダプターは Microsoft Win32GetSystemPowerStatus API を呼び出して、新しい電源状態を確認する必要があります。

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

要件

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