Partager via


IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL (winbio_ioctl.h)

La IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL retourne une structure qui contient un ensemble d’attributs pour le capteur. Les pilotes WBDI fournis par le fournisseur doivent prendre en charge cette IOCTL.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

Aucun.

Longueur de la mémoire tampon d’entrée

Aucun.

Mémoire tampon de sortie

AssociatedIrp.SystemBuffer membre pointe vers une mémoire tampon qui contient une structure de WINBIO_SENSOR_ATTRIBUTES.

Longueur de la mémoire tampon de sortie

La plus petite taille de mémoire tampon de sortie valide est la taille de DWORD. Si le pilote reçoit une mémoire tampon de sortie de taille DWORD, le pilote doit retourner la taille de la mémoire tampon nécessaire pour l’opération demandée.

Bloc d’état

Indique si l’appel DeviceIoControl au pilote est terminé et que la charge utile OUT est valide.

Le membre Status est défini sur l’une des valeurs du tableau suivant.

Valeur d’état Description
S_OK, STATUS_SUCCESS L’opération s’est terminée avec succès. Si la taille des données retournées est DWORD, la charge utile contient la taille de la mémoire tampon nécessaire pour l’appel. Sinon, la charge utile contient la mémoire tampon de sortie complète.
E_INVALIDARG Les paramètres n’ont pas été spécifiés correctement.
E_UNKNOWN Tout autre échec qui empêche le remplissage de la charge utile.
E_UNEXPECTED Tout autre échec qui empêche le remplissage de la charge utile.
E_FAIL Tout autre échec qui empêche le remplissage de la charge utile.

Remarques

Si le pilote fourni par le fournisseur transmet l’intégralité de la charge utile, il doit renseigner la WinBioHresult membre de WINBIO_SENSOR_ATTRIBUTES avec une valeur HRESULT indiquant l’état de l’opération biométrique.

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