ホーム › Devices.BiometricFramework › PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN

PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN

コールバック

シグネチャ

HRESULT PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN(
    WINBIO_PIPELINE* Pipeline,
    DWORD PowerEventType
);

パラメーター

フィールド

型

説明

Pipeline

WINBIO_PIPELINE*

操作を実行するバイオメトリックユニットに関連付けられた WINBIO_PIPELINE 構造体へのポインター。

PowerEventType

DWORD

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

値	意味
PBT_APMSUSPEND	システムが低電力状態に入ろうとしています
PBT_APMRESUMEAUTOMATIC	システムが低電力状態から復帰しようとしています。
PBT_APMPOWERSTATUSCHANGE	システムの電源の状態が変化しています (たとえば、システムがバッテリー駆動から電源に切り替わった場合や、バッテリー残量が少なくなった場合など)。

公式ドキュメント

システムが低電力状態に入る準備ができたとき、またはシステムが低電力状態から復帰したときに、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)