IOCTL_BIOMETRIC_SET_INDICATOR IOCTL (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_SET_INDICATOR IOCTL weist den Treiber an, die status der Anzeigeleuchte zu aktualisieren. Das Licht kann ein- oder ausgeschaltet werden. Diese IOCTL ist optional. Diese IOCTL muss implementiert werden, wenn der Treiber die WINBIO_CAPABILITY_INDICATOR-Funktion unterstützt.
Hauptcode
Eingabepuffer
Eingabepufferlänge
Länge einer WINBIO_SET_INDICATOR-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 in DWORD-Größe empfängt, sollte der Treiber die für den angeforderten Vorgang erforderliche Puffergröße zurückgeben.
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 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 |