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;
Member
PayloadSize
Ein DWORD-Wert, der die Gesamtgröße der Nutzlast angibt, einschließlich der Struktur mit fester Länge und allen Variablendaten am Ende.
WinBioHresult
Ein HRESULT-Wert, der angibt, status Detail des E/A-Vorgangs zu enthalten. 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 sammeln. |
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. Dieses Element könnte beispielsweise angeben, ob der Sensor erfordert, dass der Benutzer einfach den Sensor berühren oder mit dem Finger über den Sensor wischen muss.
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 mit der Fingerspitze über den Sensor wischen muss. |
| WINBIO_FP_SENSOR_SUBTYPE_TOUCH | Das Gerät erfordert, dass der Benutzer seinen gesamten Fingerabdruck auf einem Sensorpad platziert. |
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.
| Biometrischer Funktionswert | 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 unterstützen, damit eine sichere Hashberechnung zum Speichern von Vorlagen im Systempool verwendet wird. |
| 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 Anwendung im Benutzermodus in Navigationsereignisse übersetzt werden kann, ähnlich wie bei einer 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-Engine-Adapterschnittstelle 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 das Gerät geladen wird.
SupportedFormatEntries
Die Anzahl der Formate, die vom Treiber und Gerät unterstützt werden. Es muss mindestens eins vorhanden sein, wobei es sich um das Windows-Standardformat handelt.
SupportedFormat[1]
Eine Struktur vom Typ WINBIO_REGISTERED_FORMAT , die eine Liste der vom Treiber und Gerät unterstützten Formate enthält.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | winbio_ioctl.h |