IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL (winbio_ioctl.h)
Le IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL dirige le pilote pour récupérer l’analyse suivante des données biométriques. Cet appel doit placer l’appareil en mode de capture. Les pilotes WBDI fournis par le fournisseur doivent prendre en charge IOCTL_BIOMETRIC_CAPTURE_DATA.
Code principal
Mémoire tampon d’entrée
Longueur de la mémoire tampon d’entrée
Longueur d’une structure WINBIO_CAPTURE_PARAMETERS.
Mémoire tampon de sortie
AssociatedIrp.SystemBuffer membre pointe vers une mémoire tampon qui contient une structure WINBIO_CAPTURE_DATA.
Les données spécifiques au fournisseur dans la structure WINBIO_BIR peuvent être dans n’importe quel format que le fournisseur souhaite collecter auprès du pilote. Les fournisseurs peuvent choisir de traiter les données dans le pilote WBDI ou dans l’adaptateur de moteur, mais les données doivent être transmises dans une structure.
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 immédiatement retourner la taille de la mémoire tampon nécessaire pour terminer l’opération. N’attendez pas que le balayage se produise pour envoyer la taille de mémoire tampon requise.
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. |
| WINBIO_E_DATA_COLLECTION_IN_PROGRESS | L’appareil a un IOCTL_BIOMETRIC_CAPTURE_DATA en attente. |
| 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
Une seule collection de données IOCTL peut être en attente à tout moment. Si l’appareil a un IOCTL_BIOMETRIC_CAPTURE_DATA en attente, IOCTL_BIOMETRIC_CAPTURE_DATA doit retourner WINBIO_E_DATA_COLLECTION_IN_PROGRESS.
IOCTL_BIOMETRIC_CAPTURE_DATA est un IOCTL de collecte de données bloquant qui est terminé lorsque la capture de données biométriques se produit.
Si le pilote fourni par le fournisseur transmet l’intégralité de la charge utile, il doit renseigner la WinBioHresult membre de WINBIO_CAPTURE_DATA avec l’état de l’opération biométrique.
Les valeurs possibles sont les suivantes :
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 |