IOCTL_BIOMETRIC_RESET IOCTL (winbio_ioctl.h)

Die IOCTL_BIOMETRIC_RESET IOCTL setzt das Gerät entsprechend dem aktuellen Energiezustand in einen bekannten oder im Leerlauf zurück. Vom Anbieter bereitgestellte WBDI-Treiber müssen diese IOCTL unterstützen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine.

Länge des Eingabepuffers

Keine.

Ausgabepuffer

AssociatedIrp. SystemBuffer-Member zeigt auf einen Puffer, der eine WINBIO_BLANK_PAYLOAD-Struktur enthält.

Länge des Ausgabepuffers

Die Länge einer WINBIO_BLANK_PAYLOAD-Struktur .

Der vom Anbieter bereitgestellte Treiber kann optional einen Puffer im DWORD-Format 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 Status-Element wird 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	Alle anderen Fehler, die verhindern, dass die Nutzlast ausgefüllt wird.
E_UNEXPECTED	Alle anderen Fehler, die verhindern, dass die Nutzlast ausgefüllt wird.
E_FAIL	Alle anderen Fehler, die verhindern, dass die Nutzlast ausgefüllt wird.

Hinweise

IOCTL_BIOMETRIC_RESET bricht eine Datensammlungs-IOCTL ab, wenn eine aussteht. Wenn ein herstellerspezifischer Vorgang ausgeführt wird, sollte der Treiber den Vorgang abbrechen und das Gerät nach Möglichkeit zurücksetzen.

Wenn der vom Anbieter bereitgestellte Treiber die gesamte Nutzlast zurückgibt, sollte er den WinBioHresult-Member von WINBIO_BLANK_PAYLOAD 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