IOCTL_BIOMETRIC_UPDATE_FIRMWARE IOCTL (winbio_ioctl.h)

IOCTL_BIOMETRIC_UPDATE_FIRMWARE IOCTL は、指定されたファームウェアイメージを使用してデバイスのファームウェアを更新するようにドライバーに指示します。この IOCTL は省略可能です。

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

有効な出力バッファーサイズの最小は DWORD のサイズです。ドライバーが DWORD サイズの出力バッファーを受け取った場合、ドライバーは、要求された操作に必要なバッファーサイズを返す必要があります。

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

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

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

備考

ファームウェアイメージは各ベンダーに固有であり、ファームウェアデータと、ドライバーがイメージを検証するために必要な追加データの両方を含む場合があります。

デバイスに別のファームウェア更新メカニズムがある場合、ドライバーはこの IOCTL のE_NOTIMPLを返すことができます。

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

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

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