IOCTL_BIOMETRIC_CALIBRATE IOCTL (winbio_ioctl.h)

Die IOCTL_BIOMETRIC_CALIBRATE IOCTL weist den Treiber an, alle erforderlichen Schritte auszuführen, um das Gerät für die Verwendung zu kalibrieren. Intern kann der Treiber auch herstellerspezifische Kalibrierungsdaten sammeln und zurückgeben, die von einer Anwendung analysiert werden sollen. Vom Anbieter bereitgestellte WBDI-Treiber müssen diese IOCTL unterstützen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine.

Eingabepufferlänge

Keine.

Ausgabepuffer

AssociatedIrp. SystemBuffer-Member verweist auf einen Puffer, der eine WINBIO_CALIBRATION_INFO-Struktur enthält.

Länge des Ausgabepuffers

Länge einer WINBIO_CALIBRATION_INFO-Struktur .

Der vom Hersteller bereitgestellte Treiber kann optional einen Puffer in DWORD-Größe zurückgeben, der die für den angeforderten Vorgang erforderliche Puffergröße angibt.

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

Wenn der vom Anbieter bereitgestellte Treiber die gesamte Nutzlast zurückgibt, sollte er den WinBioHresult-Member von WINBIO_CALIBRATION_INFO mit dem status des biometrischen Vorgangs ausfüllen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Kopfzeile	winbio_ioctl.h