IOCTL_BIOMETRIC_UPDATE_FIRMWARE IOCTL (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_UPDATE_FIRMWARE IOCTL weist den Treiber an, die Firmware für das Gerät mit dem angegebenen Firmwareimage zu aktualisieren. Diese IOCTL ist optional.
Hauptcode
Eingabepuffer
Eingabepufferlänge
Länge einer WINBIO_UPDATE_FIRMWARE-Struktur .
Ausgabepuffer
Das AssociatedIrp.SystemBuffer-Element verweist auf einen Puffer, der eine WINBIO_BLANK_PAYLOAD-Struktur enthält.
Länge des Ausgabepuffers
Die kleinste gültige Ausgabepuffergröße ist die Größe von DWORD. Wenn der Treiber einen Ausgabepuffer im DWORD-Format empfängt, sollte der Treiber die Puffergröße zurückgeben, die für den angeforderten Vorgang erforderlich ist.
Statusblock
Gibt an, ob der DeviceIoControl-Aufruf des Treibers abgeschlossen wurde und die OUT-Nutzlast gültig ist.
Das Statuselement ist auf einen der Werte in der folgenden Tabelle festgelegt.
| Statuswert | BESCHREIBUNG |
|---|---|
| S_OK, STATUS_SUCCESS | Der Vorgang wurde erfolgreich abgeschlossen. Wenn die Größe der zurückgegebenen Daten DWORD ist, enthält die Nutzlast die Größe des Puffers, der für den Aufruf erforderlich ist. Andernfalls enthält die Nutzlast den vollständigen Ausgabepuffer. |
| E_INVALIDARG | Die Parameter wurden nicht ordnungsgemäß angegeben. |
| E_UNKNOWN | Jeder andere Fehler, der verhindert, dass die Nutzlast eingegeben wird. |
| E_UNEXPECTED | Jeder andere Fehler, der verhindert, dass die Nutzlast eingegeben wird. |
| E_FAIL | Jeder andere Fehler, der verhindert, dass die Nutzlast eingegeben wird. |
Hinweise
Das Firmwareimage ist für jeden Anbieter spezifisch und kann sowohl Firmwaredaten als auch zusätzliche Daten enthalten, die der Treiber zum Überprüfen des Images benötigt.
Wenn das Gerät über einen anderen Firmwareupdatemechanismus verfügt, kann der Treiber E_NOTIMPL für diese IOCTL zurückgeben.
Wenn der vom Anbieter bereitgestellte Treiber die gesamte Nutzlast zurückgibt, sollte er das WinBioHresult-Element von WINBIO_BLANK_PAYLOAD mit dem status des biometrischen Vorgangs ausfüllen.
Mögliche Werte sind:
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | winbio_ioctl.h |