WINBIO_CAPTURE_PARAMETERS structure (winbio_ioctl.h)
Le IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL utilise la structure WINBIO_CAPTURE_PARAMETERS comme entrée.
Syntaxe
typedef struct _WINBIO_CAPTURE_PARAMETERS {
DWORD PayloadSize;
WINBIO_BIR_PURPOSE Purpose;
WINBIO_REGISTERED_FORMAT Format;
WINBIO_UUID VendorFormat;
WINBIO_BIR_DATA_FLAGS Flags;
} WINBIO_CAPTURE_PARAMETERS, *PWINBIO_CAPTURE_PARAMETERS;
Membres
PayloadSize
Taille totale de la charge utile.
Purpose
Objectif WINBIO_BIR_PURPOSE, qui spécifie comment les données capturées doivent être utilisées et, par conséquent, comment elles doivent être optimisées. Certains capteurs passent dans un mode différent en fonction de la raison de la capture de données.
L’exemple de code suivant montre les valeurs de masque de bits possibles pour WINBIO_BIR_PURPOSE :
#define WINBIO_NO_PURPOSE_AVAILABLE ((WINBIO_BIR_PURPOSE)0x00)
#define WINBIO_PURPOSE_VERIFY ((WINBIO_BIR_PURPOSE)0x01)
#define WINBIO_PURPOSE_IDENTIFY ((WINBIO_BIR_PURPOSE)0x02)
#define WINBIO_PURPOSE_ENROLL ((WINBIO_BIR_PURPOSE)0x04)
#define WINBIO_PURPOSE_ENROLL_FOR_VERIFICATION ((WINBIO_BIR_PURPOSE)0x08)
#define WINBIO_PURPOSE_ENROLL_FOR_IDENTIFICATION ((WINBIO_BIR_PURPOSE)0x10)
#define WINBIO_PURPOSE_AUDIT ((WINBIO_BIR_PURPOSE)0x80)
Format
Spécifie le format WINBIO_REGISTERED_FORMAT des données à retourner.
VendorFormat
GUID de fournisseur de WINBIO_UUID facultatif. Cela indique le format préféré des données spécifiques au fournisseur dans le bir.
Flags
Spécifie le niveau WINBIO_BIR_DATA_FLAGS de traitement et d’autres attributs pour les données à retourner. Si le propriétaire et le type de format sont la norme Windows, cela doit être WINBIO_DATA_FLAG_RAW.
L’exemple de code suivant montre les valeurs de masque de bits possibles pour WINBIO_BIR_DATA_FLAGS :
#define WINBIO_DATA_FLAG_PRIVACY ((UCHAR)0x02)
#define WINBIO_DATA_FLAG_INTEGRITY ((UCHAR)0x01)
#define WINBIO_DATA_FLAG_SIGNED ((UCHAR)0x04)
#define WINBIO_DATA_FLAG_RAW ((UCHAR)0x20)
#define WINBIO_DATA_FLAG_INTERMEDIATE ((UCHAR)0x40)
#define WINBIO_DATA_FLAG_PROCESSED ((UCHAR)0x80)
#define WINBIO_DATA_FLAG_OPTION_MASK_PRESENT ((UCHAR)0x08) // Always '1'.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| En-tête | winbio_ioctl.h |