IOCTL_BIOMETRIC_RESET IOCTL (winbio_ioctl.h)
IOCTL_BIOMETRIC_RESET IOCTL は、現在の電源状態に従って、デバイスを既知またはアイドル状態にリセットします。 ベンダーが提供する WBDI ドライバーは、この IOCTL をサポートする必要があります。
メジャー コード
入力バッファー
何一つ。
入力バッファーの長さ
何一つ。
出力バッファー
AssociatedIrp。SystemBuffer メンバーは、WINBIO_BLANK_PAYLOAD 構造体を含むバッファーを指します。
出力バッファーの長さ
WINBIO_BLANK_PAYLOAD 構造体の長さ。
ベンダーが提供するドライバーは、必要に応じて、要求された操作に必要なバッファー サイズを指定する DWORD サイズのバッファーを返すことができます。
状態ブロック
ドライバーへの DeviceIoControl 呼び出しが完了し、OUT ペイロードが有効かどうかを示します。
Status メンバーは、次の表のいずれかの値に設定されています。
| 状態の値 | 形容 |
|---|---|
| S_OK、STATUS_SUCCESS | 操作が正常に完了しました。 返されるデータのサイズが DWORD の場合、ペイロードには呼び出しに必要なバッファーのサイズが含まれます。 それ以外の場合、ペイロードには完全な出力バッファーが含まれます。 |
| E_INVALIDARG | パラメーターが正しく指定されませんでした。 |
| E_UNKNOWN | ペイロードの入力を妨げるその他のエラー。 |
| E_UNEXPECTED | ペイロードの入力を妨げるその他のエラー。 |
| E_FAIL | ペイロードの入力を妨げるその他のエラー。 |
備考
IOCTL_BIOMETRIC_RESETは、保留中の場合、データ コレクション IOCTL を取り消します。 進行中のベンダー固有の操作がある場合、ドライバーは操作をキャンセルし、可能な限りデバイスをリセットする必要があります。
ベンダーが提供するドライバーがペイロード全体を返す場合は、WINBIO_BLANK_PAYLOADの WinBioHresult メンバーに生体認証操作の状態を入力する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
| ヘッダー | winbio_ioctl.h |