IOCTL_BIOMETRIC_GET_SENSOR_STATUS IOCTL (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_GET_SENSOR_STATUS IOCTL weist den Treiber an, alle erforderlichen Schritte auszuführen, um die aktuelle status des Geräts zu erfassen. Vom Anbieter bereitgestellte WBDI-Treiber müssen diese IOCTL unterstützen.
Hauptcode
Eingabepuffer
Keine.
Länge des Eingabepuffers
Keine.
Ausgabepuffer
AssociatedIrp. SystemBuffer-Member zeigt auf einen Puffer, der eine WINBIO_DIAGNOSTICS-Struktur enthält.
Länge des Ausgabepuffers
Die Länge einer WINBIO_DIAGNOSTICS-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
Wenn der vom Anbieter bereitgestellte Treiber die gesamte Nutzlast zurückgibt, sollte er den WinBioHresult-Member von WINBIO_DIAGNOSTICS 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 |