IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL (winbio_ioctl.h)

IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL は、生体認証データの次のスキャンを取得するようにドライバーに指示します。 この呼び出しでは、デバイスをキャプチャ モードにする必要があります。ベンダーが提供する WBDI ドライバーは、IOCTL_BIOMETRIC_CAPTURE_DATAをサポートする必要があります。

メジャー コード

IRP_MJ_DEVICE_CONTROL

入力バッファー

WINBIO_CAPTURE_PARAMETERS

入力バッファーの長さ

WINBIO_CAPTURE_PARAMETERS 構造体の長さ。

出力バッファー

AssociatedIrp。SystemBufferメンバー、WINBIO_CAPTURE_DATA 構造体を含むバッファーを指します。

WINBIO_BIR構造のベンダー固有のデータは、ベンダーがドライバーから収集する任意の形式にすることができます。 ベンダーは WBDI ドライバーまたはエンジン アダプターでデータを処理することを選択できますが、データは 1 つの構造で渡す必要があります。

出力バッファーの長さ

有効な出力バッファー サイズの最小は DWORD のサイズです。

ドライバーが DWORD サイズの出力バッファーを受け取った場合、ドライバーはすぐに操作を完了するために必要なバッファー サイズを返す必要があります。 スワイプが発生して必要なバッファー サイズが送信されるまで待つ必要はありません。

状態ブロック

ドライバーへの DeviceIoControl 呼び出しが完了し、OUT ペイロードが有効かどうかを示します。

Status メンバーは、次の表のいずれかの値に設定されています。

状態の値	形容
S_OK、STATUS_SUCCESS	操作が正常に完了しました。 返されるデータのサイズが DWORD の場合、ペイロードには呼び出しに必要なバッファーのサイズが含まれます。 それ以外の場合、ペイロードには完全な出力バッファーが含まれます。
E_INVALIDARG	パラメーターが正しく指定されませんでした。
WINBIO_E_DATA_COLLECTION_IN_PROGRESS	デバイスに保留中のIOCTL_BIOMETRIC_CAPTURE_DATAがあります。
E_UNKNOWN	ペイロードの入力を妨げるその他のエラー。
E_UNEXPECTED	ペイロードの入力を妨げるその他のエラー。
E_FAIL	ペイロードの入力を妨げるその他のエラー。

備考

保留中のデータ 収集 IOCTL は、いつでも 1 つだけです。 デバイスに保留中のIOCTL_BIOMETRIC_CAPTURE_DATAがある場合、IOCTL_BIOMETRIC_CAPTURE_DATAはWINBIO_E_DATA_COLLECTION_IN_PROGRESSを返す必要があります。

IOCTL_BIOMETRIC_CAPTURE_DATAは、生体認証データ キャプチャが発生したときに完了するブロック データ収集 IOCTL です。

ベンダーが提供するドライバーがペイロード全体を返す場合は、WINBIO_CAPTURE_DATAの WinBioHresult メンバーに生体認証操作の状態を入力する必要があります。

使用可能な値は次のとおりです。

必要条件

要件	価値
サポートされる最小クライアント	Windows 7 以降のバージョンの Windows で使用できます。
ヘッダー	winbio_ioctl.h