IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL gibt eine Struktur zurück, die einen Satz von Attributen für den Sensor enthält. Vom Anbieter bereitgestellte WBDI-Treiber müssen diese IOCTL unterstützen.
Hauptcode
Eingabepuffer
Keine.
Eingabepufferlänge
Keine.
Ausgabepuffer
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 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 Hersteller bereitgestellte Treiber die gesamte Nutzlast zurückgibt, sollte er das WinBioHresult-Element von WINBIO_SENSOR_ATTRIBUTES mit einem HRESULT-Wert ausfüllen, der die status des biometrischen Vorgangs angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | winbio_ioctl.h |