Partager via


IOCTL_BIOMETRIC_SET_INDICATOR IOCTL (winbio_ioctl.h)

Le IOCTL_BIOMETRIC_SET_INDICATOR IOCTL dirige le pilote pour mettre à jour l’état de la lumière de l’indicateur. La lumière peut être activée ou désactivée. Cette IOCTL est facultative. Cette iocTL doit être implémentée si le pilote prend en charge la fonctionnalité de WINBIO_CAPABILITY_INDICATOR.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

WINBIO_SET_INDICATOR

Longueur de la mémoire tampon d’entrée

Longueur d’une structure WINBIO_SET_INDICATOR.

Mémoire tampon de sortie

Le membre AssociatedIrp.SystemBuffer pointe vers une mémoire tampon qui contient une structure WINBIO_BLANK_PAYLOAD.

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

Si le pilote fourni par le fournisseur transmet l’intégralité de la charge utile, il doit renseigner le membre WinBioHresult de WINBIO_BLANK_PAYLOAD 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