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 cet IOCTL.
Code principal
Mémoire tampon d'entrée
Aucun.
Longueur de la mémoire tampon d’entrée
Aucun.
Mémoire tampon de sortie
AssociatedIrp. Le membre SystemBuffer pointe vers une mémoire tampon qui contient une structure 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 mémoire tampon nécessaire pour l’opération demandée.
Bloc d’état
Indique si l’appel DeviceIoControl au pilote est terminé et si 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 | Toute autre défaillance qui empêche le remplissage de la charge utile. |
| E_UNEXPECTED | Toute autre défaillance qui empêche le remplissage de la charge utile. |
| E_FAIL | Toute autre défaillance qui empêche le remplissage de la charge utile. |
Remarques
Si le pilote fourni par le fournisseur renvoie la charge utile entière, il doit remplir le membre WinBioHresult de WINBIO_SENSOR_ATTRIBUTES avec une valeur HRESULT indiquant la status de l’opération biométrique.
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 |