WINBIO_SENSOR_ATTRIBUTES Struktur (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_GET_ATTRIBUTES Struktur gibt die WINBIO_SENSOR_ATTRIBUTES Struktur als Ausgabe zurück.
Syntax
typedef struct _WINBIO_SENSOR_ATTRIBUTES {
DWORD PayloadSize;
HRESULT WinBioHresult;
WINBIO_VERSION WinBioVersion;
WINBIO_BIOMETRIC_TYPE SensorType;
WINBIO_BIOMETRIC_SENSOR_SUBTYPE SensorSubType;
WINBIO_CAPABILITIES Capabilities;
WINBIO_STRING ManufacturerName;
WINBIO_STRING ModelName;
WINBIO_STRING SerialNumber;
WINBIO_VERSION FirmwareVersion;
DWORD SupportedFormatEntries;
WINBIO_REGISTERED_FORMAT SupportedFormat[1];
} WINBIO_SENSOR_ATTRIBUTES, *PWINBIO_SENSOR_ATTRIBUTES;
Angehörige
PayloadSize
Ein DWORD-Wert, der die Gesamtgröße der Nutzlast angibt, einschließlich der Struktur fester Länge und aller Variablendaten am Ende.
WinBioHresult
Ein HRESULT-Wert, der die Statusdetails des E/A-Vorgangs angibt. Die folgende Tabelle enthält mögliche Werte.
| Statuswert | Beschreibung |
|---|---|
| S_OK | Der Vorgang wurde erfolgreich abgeschlossen. |
| HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) | Der Treiber konnte die erforderlichen Informationen nicht vom Gerät erfassen. |
WinBioVersion
Eine Struktur vom Typ WINBIO_VERSION, die eine WinBio WBDI-Version enthält, die vom Treiber unterstützt wird. Um mit dem WinBio-Dienst kompatibel zu sein, muss WinBioVersion dieselbe Hauptversion wie die aktuelle Hauptversion des WinBio-Diensts enthalten, zusätzlich zu einer Nebenversion, die kleiner oder gleich der aktuellen Nebenversion des WinBio-Diensts ist.
SensorType
Eine DWORD-Bitmaske vom Typ WINBIO_BIOMETRIC_TYPE, die biometrische Daten enthält, die vom Sensor erfasst werden. In Windows 7 wird nur WINBIO_TYPE_FINGERPRINT unterstützt.
SensorSubType
Ein WINBIO_BIOMETRIC_SENSOR_SUBTYPE Untertyp, der zusätzliche Informationen zum Sensor enthält. Beispielsweise könnte dieses Element angeben, ob der Sensor erfordert, dass der Benutzer einfach den Sensor berührt oder mit einem Finger über den Sensor wischen kann.
WINBIO_BIOMETRIC_SENSOR_SUBTYPE können die Werte in der folgenden Tabelle enthalten.
| Biometrischer Untertypwert | Beschreibung |
|---|---|
| WINBIO_FP_SENSOR_SUBTYPE_SWIPE | Das Gerät erfordert, dass der Benutzer die Fingerspitze über den Sensor streift. |
| WINBIO_FP_SENSOR_SUBTYPE_TOUCH | Das Gerät erfordert, dass der Benutzer seinen gesamten Fingerabdruck auf einem Sensorpad platzieren kann. |
Capabilities
Ein WINBIO_CAPABILITIES Untertyp, der angibt, welche Funktionen vom Gerät unterstützt werden.
WINBIO_CAPABILITIES können die Werte in der folgenden Tabelle enthalten.
| Wert der biometrischen Funktion | Beschreibung |
|---|---|
| WINBIO_CAPABILITY_SENSOR | Das Gerät kann biometrische Daten sammeln. |
| WINBIO_CAPABILITY_MATCHING | Das Gerät kann Übereinstimmungsvorgänge ausführen. |
| WINBIO_CAPABILITY_STORAGE | Das Gerät kann biometrische Vorlagen speichern. |
| WINBIO_CAPABILITY_SECURE_STORAGE | Das Gerät kann sichere Daten speichern, die einer Vorlage zugeordnet sind. Die sicheren Daten werden nur mit einer positiven Übereinstimmung freigegeben. Das Gerät muss mindestens den SHA-1-Algorithmus für die sichere Hashberechnung unterstützen, die zum Speichern von Vorlagen im Systempool verwendet werden soll. |
| WINBIO_CAPABILITY_PROCESSING | Das Gerät kann Proben verarbeiten und in biometrische Vorlagen umwandeln. |
| WINBIO_CAPABILITY_ENCRYPTION | Das Gerät unterstützt die Verschlüsselung von Beispielen und Vorlagen. |
| WINBIO_CAPABILITY_SIGNING | Das Gerät kann erfasste Daten signieren. |
| WINBIO_CAPABILITY_NAVIGATION | Das Gerät kann als Navigationsgerät verwendet werden. Einige Geräte und Treiber können Daten in einem Format erfassen, das von einer Benutzermodusanwendung in Navigationsereignisse übersetzt werden kann, ähnlich wie eine Maus. |
| WINBIO_CAPABILITY_INDICATOR | Das Gerät verfügt über einen Indikator, der ein- oder ausgeschaltet werden kann. |
| WINBIO_CAPABILITY_VIRTUAL_SENSOR | Der Sensoradapter verwaltet eine eigene Verbindung mit der biometrischen Hardware. Hinweis: Diese Konstante gilt nur für Windows 10 und höher. |
| WINBIO_CAPABILITY_SECURE_SENSOR | Das Gerät unterstützt Sicherheitsmethoden, die in der WinBio-Moduladapterschnittstelle, Version 4.0 oder höher, verfügbar sind. Hinweis: Diese Konstante gilt nur für Windows 10 und höher. |
ManufacturerName
Eine Struktur vom Typ WINBIO_STRING, die den Namen des Geräteherstellers enthält.
ModelName
Eine Struktur vom Typ WINBIO_STRING, die den Namen des Gerätemodells enthält.
SerialNumber
Eine Struktur vom Typ WINBIO_STRING, die die Seriennummer des Geräts enthält, sofern vorhanden.
FirmwareVersion
Eine Struktur vom Typ WINBIO_VERSION, die die Version der Firmware enthält, die auf dem Gerät geladen wird.
SupportedFormatEntries
Die Anzahl der Formate, die vom Treiber und Gerät unterstützt werden. Es muss mindestens ein Standardformat vorhanden sein.
SupportedFormat[1]
Eine Struktur vom Typ WINBIO_REGISTERED_FORMAT, die eine Liste der formate enthält, die vom Treiber und Gerät unterstützt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Header- | winbio_ioctl.h |