WINBIO_SENSOR_ATTRIBUTES structure (winbio_ioctl.h)
La structure IOCTL_BIOMETRIC_GET_ATTRIBUTES retourne la structure WINBIO_SENSOR_ATTRIBUTES en tant que sortie.
Syntaxe
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;
Membres
PayloadSize
Valeur DWORD qui indique la taille totale de la charge utile, y compris la structure de longueur fixe et toutes les données variables à la fin.
WinBioHresult
Valeur HRESULT qui indique que contient status détail de l’opération d’E/S. Le tableau suivant inclut les valeurs possibles.
| Valeur d’état | Description |
|---|---|
| S_OK | L’opération s’est terminée avec succès. |
| HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) | Le pilote n’a pas pu recueillir les informations nécessaires à partir de l’appareil. |
WinBioVersion
Structure de type WINBIO_VERSION qui contient une version WinBio WBDI prise en charge par le pilote. Pour être compatible avec le service WinBio, WinBioVersion doit contenir la même version majeure que la version principale actuelle du service WinBio, en plus d’une version mineure inférieure ou égale à la version mineure actuelle du service WinBio.
SensorType
Masque de bits DWORD de type WINBIO_BIOMETRIC_TYPE qui contient des données biométriques collectées par le capteur. Dans Windows 7, seule WINBIO_TYPE_FINGERPRINT est prise en charge.
SensorSubType
Un WINBIO_BIOMETRIC_SENSOR_SUBTYPE sous-type qui contient des informations supplémentaires sur le capteur. Par exemple, ce membre peut spécifier si le capteur exige que l’utilisateur touche simplement le capteur ou balaye un doigt sur le capteur.
WINBIO_BIOMETRIC_SENSOR_SUBTYPE peut contenir les valeurs du tableau suivant.
| Valeur de sous-type biométrique | Description |
|---|---|
| WINBIO_FP_SENSOR_SUBTYPE_SWIPE | L’appareil nécessite que l’utilisateur effectue un mouvement de balayage du bout du doigt sur le capteur. |
| WINBIO_FP_SENSOR_SUBTYPE_TOUCH | L’appareil exige que l’utilisateur place l’intégralité de son empreinte digitale sur un pavé de capteur. |
Capabilities
Un WINBIO_CAPABILITIES sous-type, qui indique les fonctionnalités prises en charge par l’appareil.
WINBIO_CAPABILITIES peuvent contenir les valeurs du tableau suivant.
| Valeur de capacité biométrique | Description |
|---|---|
| WINBIO_CAPABILITY_SENSOR | L’appareil peut collecter des données biométriques. |
| WINBIO_CAPABILITY_MATCHING | L’appareil peut effectuer des opérations de correspondance. |
| WINBIO_CAPABILITY_STORAGE | L’appareil peut stocker des modèles biométriques. |
| WINBIO_CAPABILITY_SECURE_STORAGE | L’appareil peut stocker des données sécurisées associées à un modèle. Les données sécurisées ne sont publiées qu’avec une correspondance positive. L’appareil doit prendre en charge au moins l’algorithme SHA-1 pour le calcul de hachage sécurisé à utiliser pour stocker des modèles dans le pool système. |
| WINBIO_CAPABILITY_PROCESSING | L’appareil peut traiter des échantillons et les transformer en modèles biométriques. |
| WINBIO_CAPABILITY_ENCRYPTION | L’appareil prend en charge le chiffrement des exemples et des modèles. |
| WINBIO_CAPABILITY_SIGNING | L’appareil peut signer les données capturées. |
| WINBIO_CAPABILITY_NAVIGATION | L’appareil peut être utilisé comme appareil de navigation. Certains périphériques et pilotes peuvent capturer des données dans un format qui peut être traduit par une application en mode utilisateur en événements de navigation, comme une souris. |
| WINBIO_CAPABILITY_INDICATOR | L’appareil a un indicateur qui peut être activé ou désactivé. |
| WINBIO_CAPABILITY_VIRTUAL_SENSOR | L’adaptateur de capteur gère sa propre connexion au matériel biométrique. Note: Cette constante s’applique uniquement aux Windows 10 et versions ultérieures. |
| WINBIO_CAPABILITY_SECURE_SENSOR | L’appareil prend en charge les méthodes de sécurité disponibles dans l’interface d’adaptateur de moteur WinBio version 4.0 ou ultérieure. Note: Cette constante s’applique uniquement aux Windows 10 et versions ultérieures. |
ManufacturerName
Structure de type WINBIO_STRING qui contient le nom du fabricant de l’appareil.
ModelName
Structure de type WINBIO_STRING qui contient le nom du modèle d’appareil.
SerialNumber
Structure de type WINBIO_STRING qui contient le numéro de série de l’appareil, le cas échéant.
FirmwareVersion
Structure de type WINBIO_VERSION qui contient la version du microprogramme chargé sur l’appareil.
SupportedFormatEntries
Nombre de formats pris en charge par le pilote et le périphérique. Il doit y en avoir au moins un, c’est-à-dire le format standard Windows.
SupportedFormat[1]
Structure de type WINBIO_REGISTERED_FORMAT qui contient une liste des formats pris en charge par le pilote et le périphérique.
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 |