Partager via


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

Voir aussi

IOCTL_BIOMETRIC_GET_ATTRIBUTES