structure WINBIO_CAPTURE_DATA (winbio_ioctl.h)
La IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL retourne la structure WINBIO_CAPTURE_DATA comme sortie.
Syntaxe
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;
Membres
PayloadSize
Taille totale de la charge utile. Cela inclut la structure de longueur fixe et toutes les données variables à la fin.
WinBioHresult
Détail de l’état de l’opération d’E/S. C’est là que les codes d’erreur et d’informations WINBIO sont transmis. Le tableau suivant présente les valeurs possibles pour ce membre.
| Valeur d’état | Description |
|---|---|
| S_OK | L’opération s’est terminée avec succès. |
| WINBIO_E_DATA_COLLECTION_IN_PROGRESS | Il existe déjà une collection de données IOCTL en attente. |
| WINBIO_E_UNSUPPORTED_DATA_FORMAT | Le format spécifié n’est pas pris en charge par ce pilote et ce périphérique. |
| WINBIO_E_UNSUPPORTED_DATA_TYPE | Le type de données demandé n’est pas pris en charge par ce pilote et ce périphérique. |
| WINBIO_E_INVALID_DEVICE_STATE | L’appareil n’a pas pu être placé en mode de capture biométrique. Cela peut être dû au fait que l’appareil se trouve en un autre mode de collecte de données. |
| HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) | L’opération n’a pas été terminée en raison d’une erreur d’appareil. |
| WINBIO_E_DEVICE_BUSY | L’appareil est au milieu d’une opération spécifique au fournisseur. |
| WINBIO_E_CANCELED | L’opération a été annulée par l’appelant ou par une demande de IOCTL_BIOMETRIC_RESET. |
| WINBIO_E_UNSUPPORTED_PURPOSE | L’objectif de capture spécifié n’est pas pris en charge par le pilote. |
SensorStatus
État WINBIO_SENSOR_STATUS du capteur une fois la capture effectuée. Il spécifie l’état d’exploitation du capteur.
WINBIO_SENSOR_STATUS peut être interrogé à tout moment. Lorsque WINBIO_SENSOR_STATUS est retourné à une fin d’E/S de capture, elle indique si une capture a réussi. Les valeurs possibles sont indiquées dans le tableau suivant.
| Code d’état du capteur | Description |
|---|---|
| WINBIO_SENSOR_ACCEPT | Le capteur vient d’effectuer une opération de capture. Cette opération ne doit être retournée qu’après une opération de capture. Le capteur retourne ensuite à WINBIO_SENSOR_READY ou WINBIO_SENSOR_BUSY. |
| WINBIO_SENSOR_REJECT | Le capteur a rejeté l’opération de capture précédente. Cette opération ne doit être retournée que immédiatement après une opération de capture. Le capteur retourne ensuite à WINBIO_SENSOR_READY ou WINBIO_SENSOR_BUSY. |
| WINBIO_SENSOR_READY | Le capteur est prêt à capturer des données. S’il existe une capture de données en attente IOCTL, le capteur est prêt à accepter les données. |
| WINBIO_SENSOR_BUSY | Le capteur est occupé ou dans un état où il ne peut pas capturer les données. Par exemple, l’appareil peut toujours être initialisé une fois qu’il a été activé. |
| WINBIO_SENSOR_NOT_CALIBRATED | Le capteur doit être étalonné avant d’être placé en mode de collecte de données. |
| WINBIO_SENSOR_FAILURE | L’appareil de capteur a échoué. |
RejectDetail
Si l’état du capteur était WINBIO_SENSOR_REJECT, ce membre contient une valeur WINBIO_REJECT_DETAIL. WINBIO_SENSOR_REJECT spécifie la raison pour laquelle une opération d’échantillonnage biométrique a échoué.
#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
Structure de type WINBIO_DATA qui contient les données capturées par l’appareil, du format spécifié. Le membre de tableau data de la structure WINBIO_DATA doit contenir une structure WINBIO_BIR.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| d’en-tête | winbio_ioctl.h |