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 で使用できます。
Header	winbio_ioctl.h