IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL (winbio_ioctl.h)
La IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL récupère une liste d’algorithmes de hachage de chiffrement pris en charge par l’appareil. Cette IOCTL est facultative.
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.SystemBuffer membre pointe vers une mémoire tampon qui contient une structure WINBIO_SUPPORTED_ALGORITHMS.
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
Les algorithmes sont spécifiés à l’aide de chaînes encodées UTF-8 terminées par NULL. Les chaînes « OID » de l’identificateur d’algorithme sont définies dans RFC 3279 et RFC 3278 .
Voici des exemples de chaînes OID pour les algorithmes de hachage.
| Algorithme | Chaîne d’identificateur d’algorithme |
|---|---|
| SHA-1 | "1.3.14.3.2.26" |
| SHA-256 | "2.16.840.1.101.3.4.2.1" |
| SHA-384 | "2.16.840.1.101.3.4.2.2" |
| SHA-512 | "2.16.840.1.101.3.4.2.3" |
IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS devez être implémenté si l’appareil prend en charge WINBIO_CAPABILITY_SECURE_STORAGE. L’appareil doit prendre en charge au moins SHA-1 (« 1.3.14.3.2.26 ») à utiliser pour stocker des modèles WinBio.
Si le pilote fourni par le fournisseur transmet l’intégralité de la charge utile, il doit renseigner la WinBioHresult membre de WINBIO_SUPPORTED_ALGORITHMS 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 |