Partager via


KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE est un ID de propriété utilisé pour activer et désactiver l’authentification faciale.

Tableau récapitulatif de l’utilisation

Étendue Control Type

version 1

Épingle

Synchrone

Les indicateurs de bits suivants contrôlent l’authentification faciale dans le pilote :

#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED                        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION  0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION          0x0000000000000004

Le tableau suivant décrit les fonctionnalités d’indicateur :

Indicateur Description

KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED

Fonctionnalité facultative.

Lorsqu’il est spécifié, le mode d’authentification visage vidéo est désactivé dans le pilote. Cet indicateur s’exclue mutuellement avec les indicateurs KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION et KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION .

KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION

Fonctionnalité obligatoire si KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION n’est pas pris en charge.

Lorsqu’il est spécifié, il est obligatoire de définir KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION sur chaque exemple, comme décrit par les métadonnées de trame. Cet indicateur s’exclue mutuellement avec les indicateurs KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION et KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED . Dans ce mode, il est prévu d’alterner le stroboscope IR activé/désactivé pour chaque image capturée.

KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION

Fonctionnalité obligatoire si KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION n’est pas pris en charge.

Cet indicateur s’exclue mutuellement avec les indicateurs KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION et KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED . Dans ce mode, il est prévu de créer une image IR avec la lumière ir ambiante d’arrière-plan soustraite.

Par défaut, le pilote doit avoir KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE défini sur KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED s’il s’agit d’une caméra IR à usage général. Sinon, il doit être défini sur KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION ou KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION.

Les caméras ir doivent publier des KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED si elles sont censées fonctionner pour des scénarios généraux en plus de Windows Hello.

Les caméras IR utilisées pour la connexion du visage doivent prendre en charge KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION ou KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION fonctionnalité, elles ne doivent prendre en charge qu’un seul de ces indicateurs et non les deux.

Le tableau suivant contient les descriptions et les conditions requises pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation du contrôle.

Membre Description

Version

Cela doit être 1.

PinId

Ne doit être publié que sur une seule broche sur le filtre. La broche doit être de type PINNAME_VIDEO_CAPTURE ou PINNAME_VIDEO_PREVIEW, doit produire des données du capteur IR et être marquée comme partageable pour FrameServer.

Taille

Il doit s’agir de sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING).

Résultats

Indique les résultats d’erreur de la dernière opération SET. Si aucune opération SET n’a eu lieu, il doit s’agir de 0.

Fonctionnalité

Doit être un peu sage OR des indicateurs de KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx pris en charge, comme défini ci-dessus.

Le conducteur ne doit pas publier à la fois KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION et KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION

Indicateurs

Il s’agit d’un champ en lecture/écriture. Il peut s’agir d’un des indicateurs KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx définis ci-dessus.

Configuration requise

En-tête

Ksmedia.h