IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL (winbio_ioctl.h)
IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL は、センサーの属性のセットを含む構造体を返します。 ベンダーが提供する WBDI ドライバーは、この IOCTL をサポートする必要があります。
メジャー コード
[入力バッファー]
[なし] :
入力バッファーの長さ
[なし] :
出力バッファー
AssociatedIrp。SystemBuffer メンバーは、WINBIO_SENSOR_ATTRIBUTES構造体を含むバッファーを指します。
出力バッファーの長さ
有効な出力バッファー サイズの最小は、DWORD のサイズです。 ドライバーが DWORD サイズの出力バッファーを受け取った場合、ドライバーは要求された操作に必要なバッファー サイズを返す必要があります。
ステータス ブロック
ドライバーへの DeviceIoControl 呼び出しが完了し、OUT ペイロードが有効かどうかを示します。
Status メンバーは、次の表のいずれかの値に設定されます。
| ステータス値 | 説明 |
|---|---|
| S_OK、STATUS_SUCCESS | 操作は正常に完了しました。 返されるデータのサイズが DWORD の場合、ペイロードには呼び出しに必要なバッファーのサイズが含まれます。 それ以外の場合、ペイロードには完全な出力バッファーが含まれます。 |
| E_INVALIDARG | パラメーターが正しく指定されていません。 |
| E_UNKNOWN | ペイロードの入力を妨げるその他のエラー。 |
| E_UNEXPECTED | ペイロードの入力を妨げるその他のエラー。 |
| E_FAIL | ペイロードの入力を妨げるその他のエラー。 |
注釈
ベンダーが指定したドライバーがペイロード全体を返す場合は、生体認証操作の状態を示す HRESULT 値をWINBIO_SENSOR_ATTRIBUTESの WinBioHresult メンバーに入力する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
| Header | winbio_ioctl.h |