ホーム › Devices.BiometricFramework › PWINBIO_LOCATE_SENSOR_CALLBACK

PWINBIO_LOCATE_SENSOR_CALLBACK

コールバック

シグネチャ

void PWINBIO_LOCATE_SENSOR_CALLBACK(
    void* LocateCallbackContext,
    HRESULT OperationStatus,
    DWORD UnitId
);

パラメーター

フィールド	型	説明
LocateCallbackContext	void*	アプリケーションが定義し、WinBioLocateSensorWithCallback 関数の LocateCallbackContext パラメーターに渡したバッファーへのポインター。このバッファーは、フレームワークやバイオメトリックユニットによって変更されることはありません。アプリケーションは、このデータを利用して実行すべき処理を判断したり、生体情報のキャプチャに関する追加情報を保持したりできます。
OperationStatus	HRESULT	キャプチャ操作から返されたエラーコード。
UnitId	DWORD	バイオメトリックユニットの ID 番号。

公式ドキュメント

非同期の WinBioLocateSensorWithCallback 関数の結果を返すために、Windows Biometric Framework から呼び出されます。クライアントアプリケーションは、この関数を実装する必要があります。

重要 Windows 8 以降では、PWINBIO_LOCATE_SENSOR_CALLBACK/WinBioLocateSensorWithCallback の組み合わせを使用しないことをお勧めします。代わりに、次の手順を実行してください。

操作の完了時に通知を受け取るために、PWINBIO_ASYNC_COMPLETION_CALLBACK 関数を実装します。
WinBioAsyncOpenSession 関数を呼び出します。CallbackRoutine パラメーターにはコールバックのアドレスを渡します。NotificationMethod パラメーターには WINBIO_ASYNC_NOTIFY_CALLBACK を渡します。そして、非同期セッションハンドルを取得します。
非同期セッションハンドルを使用して WinBioLocateSensor を呼び出します。操作が完了すると、Windows Biometric Framework は結果を格納した WINBIO_ASYNC_RESULT 構造体を割り当てて初期化し、その結果構造体へのポインターを指定してコールバックを呼び出します。
コールバックの実装内で、WINBIO_ASYNC_RESULT 構造体の使用が終わったら、WinBioFree を呼び出して解放します。

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