Win32 API 日本語リファレンス
ホーム › Devices.BiometricFramework › PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN

PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN

コールバック

シグネチャ

HRESULT PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN(
    WINBIO_PIPELINE* Pipeline,
    DWORD PowerEventType
);

パラメーター

フィールド型説明
PipelineWINBIO_PIPELINE*操作を実行するバイオメトリック ユニットに関連付けられた WINBIO_PIPELINE 構造体へのポインター。
PowerEventTypeDWORD

変化の種類を示します。次のいずれかの値を指定できます。

システムが低電力状態に入ろうとしています。

システムが低電力状態から復帰しています。

システムの電源の状態が変化しています (たとえば、システムがバッテリ駆動から電源接続に切り替わった、またはバッテリ残量が少なくなった場合など)。

公式ドキュメント

コンピューターが低電力状態に入る準備ができたとき、またはコンピューターが低電力状態から復帰したときに、Windows Biometric Framework によって呼び出されます。この関数の目的は、コンピューターの電源状態の遷移にアダプターが対応できるようにすることです。

戻り値

関数が成功した場合は S_OK を返します。関数が失敗した場合は、エラーを示す HRESULT 値を返します。指定できる値には次の表に示すものが含まれますが、これらに限定されません。一般的なエラー コードの一覧については、Common HRESULT Values を参照してください。

解説(Remarks)

PBT_APMPOWERSTATUSCHANGE イベントを受け取ったアダプターは、Microsoft Win32 の GetSystemPowerStatus API を呼び出して、新しい電源状態を確認する必要があります。

バイオメトリック フレームワークは、このアダプターのエントリ ポイントを任意のスレッドのコンテキストで非同期に呼び出します。この呼び出しの処理と、アダプターが実行している他の処理との同期を取ることは、アダプターの責任です。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)