IOCTL_BIOMETRIC_CALIBRATE IOCTL (winbio_ioctl.h)
Le IOCTL_BIOMETRIC_CALIBRATE IOCTL demande au pilote d’effectuer toutes les étapes nécessaires pour étalonner l’appareil en vue de son utilisation. En interne, le pilote peut également collecter et retourner des données d’étalonnage spécifiques au fournisseur à analyser par une application. Les pilotes WBDI fournis par le fournisseur doivent prendre en charge ce 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_CALIBRATION_INFO.
Longueur de la mémoire tampon de sortie
Longueur d’une structure WINBIO_CALIBRATION_INFO .
Le pilote fourni par le fournisseur peut éventuellement retourner une mémoire tampon de taille DWORD qui spécifie la taille de mémoire tampon nécessaire pour l’opération demandée.
Bloc d’état
Indique si l’appel DeviceIoControl au pilote s’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 empêchant le remplissage de la charge utile. |
| E_UNEXPECTED | Toute autre défaillance empêchant le remplissage de la charge utile. |
| E_FAIL | Toute autre défaillance empêchant 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 le membre WinBioHresult de WINBIO_CALIBRATION_INFO avec le 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 |