IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL gibt eine Struktur zurück, die eine Reihe von Attributen für den Sensor enthält. 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_SENSOR_ATTRIBUTES Struktur enthält.
Länge des Ausgabepuffers
Die kleinste gültige Ausgabepuffergröße ist die Größe von DWORD. Wenn der Treiber einen DWORD-Ausgabepuffer 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 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
Wenn der vom Anbieter bereitgestellte Treiber die gesamte Nutzlast zurückgibt, sollte er das WinBioHresult Mitglied von WINBIO_SENSOR_ATTRIBUTES mit einem HRESULT-Wert ausfüllen, der den Status des biometrischen Vorgangs angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Header- | winbio_ioctl.h |