IOCTL_BIOMETRIC_CALIBRATE IOCTL (winbio_ioctl.h)

Le IOCTL_BIOMETRIC_CALIBRATE IOCTL dirige le pilote à effectuer toutes les étapes nécessaires pour étalonner l’appareil à utiliser. En interne, le pilote peut également collecter et retourner des données d’étalonnage spécifiques du fournisseur à analyser par une application. 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 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 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 renvoie la charge utile entière, il doit renseigner la WinBioHresult membre de WINBIO_CALIBRATION_INFO avec 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