PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN コールバック関数 (winbio_adapter.h)

  • [アーティクル]

システムが低電力状態に入る準備ができた場合、または低電力状態からシステムが起動されたときに、Windows 生体認証フレームワークによって呼び出されます。 この機能の目的は、アダプターがコンピューターの電源状態の遷移に応答できるようにすることです。

構文

PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN PibioStorageNotifyPowerChangeFn;

HRESULT PibioStorageNotifyPowerChangeFn(
  [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 Win32 GetSystemPowerStatus API を呼び出して、新しい電源状態を確認する必要があります。

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

要件

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

こちらもご覧ください

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE