WINBIO_CAPTURE_DATA-Struktur (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL gibt die WINBIO_CAPTURE_DATA-Struktur als Ausgabe zurück.
Syntax
typedef struct _WINBIO_CAPTURE_DATA {
DWORD PayloadSize;
HRESULT WinBioHresult;
WINBIO_SENSOR_STATUS SensorStatus;
WINBIO_REJECT_DETAIL RejectDetail;
WINBIO_DATA CaptureData;
} WINBIO_CAPTURE_DATA, *PWINBIO_CAPTURE_DATA;
Member
PayloadSize
Die Gesamtgröße der Nutzlast. Dies umfasst die Struktur mit fester Länge und alle Variablendaten am Ende.
WinBioHresult
Die status Detail des E/A-Vorgangs. Hier werden WINBIO-Fehler- und Informationscodes übergeben. Die folgende Tabelle zeigt mögliche Werte für dieses Element.
| Statuswert | BESCHREIBUNG |
|---|---|
| S_OK | Der Vorgang wurde erfolgreich abgeschlossen. |
| WINBIO_E_DATA_COLLECTION_IN_PROGRESS | Es ist bereits eine Datensammlung IOCTL ausstehend. |
| WINBIO_E_UNSUPPORTED_DATA_FORMAT | Das angegebene Format wird von diesem Treiber und Gerät nicht unterstützt. |
| WINBIO_E_UNSUPPORTED_DATA_TYPE | Der Typ der angeforderten Daten wird von diesem Treiber und Gerät nicht unterstützt. |
| WINBIO_E_INVALID_DEVICE_STATE | Das Gerät konnte nicht in den biometrischen Erfassungsmodus versetzt werden. Dies kann darauf zurückzuführen sein, dass sich das Gerät in einem anderen Nicht-Datensammlungsmodus befindet. |
| HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) | Der Vorgang wurde aufgrund eines Gerätefehlers nicht abgeschlossen. |
| WINBIO_E_DEVICE_BUSY | Das Gerät befindet sich in der Mitte eines herstellerspezifischen Vorgangs. |
| WINBIO_E_CANCELED | Der Vorgang wurde entweder vom Aufrufer oder von einer IOCTL_BIOMETRIC_RESET-Anforderung abgebrochen. |
| WINBIO_E_UNSUPPORTED_PURPOSE | Der angegebene Erfassungszweck wird vom Treiber nicht unterstützt. |
SensorStatus
Die WINBIO_SENSOR_STATUS status des Sensors nach der Erfassung. Er gibt die status des Sensors an.
WINBIO_SENSOR_STATUS können jederzeit abgefragt werden. Wenn WINBIO_SENSOR_STATUS nach Abschluss einer Erfassungs-E/A zurückgegeben wird, gibt dies an, ob eine Erfassung erfolgreich war. Mögliche Werte werden in der folgenden Tabelle angezeigt.
| Sensorcode status | BESCHREIBUNG |
|---|---|
| WINBIO_SENSOR_ACCEPT | Der Sensor hat gerade einen Erfassungsvorgang erfolgreich abgeschlossen. Diese sollte nur unmittelbar nach einem Erfassungsvorgang zurückgegeben werden. Der Sensor kehrt dann zu WINBIO_SENSOR_READY oder WINBIO_SENSOR_BUSY zurück. |
| WINBIO_SENSOR_REJECT | Der Sensor hat den vorherigen Erfassungsvorgang abgelehnt. Diese sollte nur unmittelbar nach einem Erfassungsvorgang zurückgegeben werden. Der Sensor kehrt dann zu WINBIO_SENSOR_READY oder WINBIO_SENSOR_BUSY zurück. |
| WINBIO_SENSOR_READY | Der Sensor ist bereit, Daten zu erfassen. Wenn ein IOCTL für die Datenerfassung aussteht, ist der Sensor bereit, Daten zu akzeptieren. |
| WINBIO_SENSOR_BUSY | Der Sensor ist ausgelastet oder in einem Zustand, in dem er keine Daten erfassen kann. Beispielsweise könnte das Gerät auch nach dem Einschalten initialisiert werden. |
| WINBIO_SENSOR_NOT_CALIBRATED | Der Sensor muss kalibriert werden, bevor er in den Datensammlungsmodus versetzt wird. |
| WINBIO_SENSOR_FAILURE | Fehler beim Sensorgerät. |
RejectDetail
Wenn der Sensor status WINBIO_SENSOR_REJECT war, enthält dieser Member einen WINBIO_REJECT_DETAIL Wert. WINBIO_SENSOR_REJECT gibt den Grund an, warum ein biometrischer Stichprobenentnahmevorgang fehlgeschlagen ist.
#define WINBIO_FP_TOO_HIGH ((WINBIO_REJECT_DETAIL)1)
#define WINBIO_FP_TOO_LOW ((WINBIO_REJECT_DETAIL)2)
#define WINBIO_FP_TOO_LEFT ((WINBIO_REJECT_DETAIL)3)
#define WINBIO_FP_TOO_RIGHT ((WINBIO_REJECT_DETAIL)4)
#define WINBIO_FP_TOO_FAST ((WINBIO_REJECT_DETAIL)5)
#define WINBIO_FP_TOO_SLOW ((WINBIO_REJECT_DETAIL)6)
#define WINBIO_FP_POOR_QUALITY ((WINBIO_REJECT_DETAIL)7)
#define WINBIO_FP_TOO_SKEWED ((WINBIO_REJECT_DETAIL)8)
#define WINBIO_FP_TOO_SHORT ((WINBIO_REJECT_DETAIL)9)
#define WINBIO_FP_MERGE_FAILURE ((WINBIO_REJECT_DETAIL)10)
CaptureData
Eine Struktur vom Typ WINBIO_DATA , die vom Gerät erfasste Daten des angegebenen Formats enthält. Das Datenarrayelement der WINBIO_DATA-Struktur sollte eine WINBIO_BIR-Struktur enthalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | winbio_ioctl.h |