IOCTL_BIOMETRIC_RESET IOCTL (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_RESET IOCTL setzt das Gerät entsprechend dem aktuellen Energiezustand auf einen bekannten oder leerlaufzustand zurück. Vom Anbieter bereitgestellte WBDI-Treiber müssen diese IOCTL unterstützen.
Hauptcode
Eingabepuffer
Nichts.
Eingabepufferlänge
Nichts.
Ausgabepuffer
Die AssociatedIrp.SystemBuffer Member verweist 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 DWORD-Größenpuffer zurückgeben, der die für den angeforderten Vorgang erforderliche Puffergröße angibt.
Statusblock
Gibt an, ob der DeviceIoControl-Aufruf des Treibers abgeschlossen ist und die OUT-Nutzlast gültig ist.
Der Status Member wird auf einen der Werte in der folgenden Tabelle festgelegt.
| Statuswert | Beschreibung |
|---|---|
| S_OK, STATUS_SUCCESS | Der Vorgang wurde erfolgreich abgeschlossen. Wenn die zurückgegebene Datengröße DWORD ist, enthält die Nutzlast die Größe des für den Aufruf erforderlichen Puffers. 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 ausgefüllt wird. |
| E_UNEXPECTED | Jeder andere Fehler, der verhindert, dass die Nutzlast ausgefüllt wird. |
| E_FAIL | Jeder andere Fehler, der verhindert, dass die Nutzlast ausgefüllt wird. |
Bemerkungen
IOCTL_BIOMETRIC_RESET bricht eine IOCTL-Datensammlung ab, wenn eine aussteht. Wenn ein anbieterspezifischer 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 das WinBioHresult Mitglied der WINBIO_BLANK_PAYLOAD mit dem Status des biometrischen Vorgangs ausfüllen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Header- | winbio_ioctl.h |