Partager via


Codes de contrôle personnalisés

Les fournisseurs peuvent définir des codes de contrôle personnalisés à partir de 0x800.

Pour définir des codes de contrôle d’E/S spécifiques au fournisseur, utilisez la macro CTL_CODE fournie par le système avec les arguments suivants :

#define IOCTL_BIOMETRIC_Device_Function CTL_CODE(FILE_DEVICE_BIOMETRIC, Function, METHOD_BUFFERED, FILE_ANY_ACCESS)

Tous les paramètres d’entrée/sortie sont définis par le fournisseur. 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.

Les IOCTL définis par le fournisseur peuvent être utilisés pour toutes les opérations spécifiques au fournisseur. Ces appels passent par le service biométrique Windows, qui a le contrôle exclusif de l’appareil. Voici quelques exemples de la façon dont les fournisseurs peuvent utiliser les IOCTL spécifiques aux fournisseurs :

  • Configurez des sessions sécurisées propriétaires entre une application ou un composant et l’appareil.
  • Interface avec des fonctionnalités de correspondance et de stockage sur l’appareil à partir d’un moteur WinBio ou d’un plug-in de base de données.
  • Pendez les E/S pour les événements d’appareil spécifiques au fournisseur.
  • Gérer les sessions spécifiques au fournisseur.

Cette fonctionnalité est disponible dans Windows 7 et versions ultérieures de Windows.