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

PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN

コールバック

シグネチャ

HRESULT PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN(
    WINBIO_PIPELINE* Pipeline,
    DWORD PowerEventType
);

パラメーター

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

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

システムは低電力状態に移行しようとしています。

システムは低電力状態から復帰しようとしています。

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

公式ドキュメント

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

戻り値

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

戻り値 説明
E_POINTER
 Pipeline 引数が NULL でした。
E_INVALIDARG
 PowerEventType 引数が、列挙されている値のいずれでもありませんでした。

解説(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)