Partager via

KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

  • Article

Ce contrôle de propriété étendu est utilisé par le client pour contrôler le niveau de puissance et le cycle d’utilisation de la torche infrarouge d’une caméra IR. Il est envoyé au pilote avec une structure de KSCAMERA_EXTENDEDPROP_HEADER standard suivie d’une structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

Tableau récapitulatif de l’utilisation

Get Set Cible Type de descripteur de propriété Type de valeur de propriété
Oui Oui Filtrer KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

Remarques

La demande de propriété contient une structure KSCAMERA_EXTENDEDPROP_HEADER et une structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

La taille totale des données de propriété est sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Le membre Size de KSCAMERA_EXTENDEDPROP_HEADER est défini sur cette taille totale des données de propriété.

Les indicateurs suivants peuvent être placés dans le KSCAMERA_EXTENDEDPROP_HEADER. Indicateurs et KSCAMERA_EXTENDEDPROP_HEADER. Champs de capacité . Ils définissent le ou les modes de fonctionnement de la torche IR.

Mode Torch Description
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF Désactivé
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON Always on
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION Activé pour un cadre sur deux

KSCAMERA_EXTENDEDPROP_IRTORCHMODE est toujours un contrôle synchrone. Le contrôle n’a aucun comportement défini lorsque la caméra n’est pas diffusée en continu.

Pour une requête GET, un pilote définit les champs suivants :

  • KSCAMERA_EXTENDEDPROP_HEADER. Fonctionnalité avec un masque de bits des indicateurs KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX ci-dessus représentant les modes de fonctionnement pris en charge par l’appareil photo.
  • KSCAMERA_EXTENDEDPROP_HEADER. Indicateurs de l’un des indicateurs KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX ci-dessus pour indiquer le mode de fonctionnement actuel.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Mode à 0.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Minimum jusqu’au niveau d’alimentation minimum disponible.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Max jusqu’au niveau d’alimentation maximal disponible.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Pas à pas jusqu’à l’incrément minimal entre les niveaux d’alimentation.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul au niveau d’alimentation actuel. Cette valeur doit par défaut avoir le même niveau d’alimentation que celui utilisé normalement par le contrôle d’authentification des visages.

Pour une requête SET, un pilote utilise les champs suivants :

  • KSCAMERA_EXTENDEDPROP_HEADER. Indicateurs pour définir un mode de fonctionnement.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul pour définir un niveau d’alimentation. Cette valeur n’a aucun effet sur KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF.

Le tableau ci-dessous contient les descriptions et les exigences pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation du contrôle de métadonnées.

Membre Description

Version

Cela doit être 1.

PinId

KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Taille

Il doit s’agir de sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting)),

Résultats

Cette valeur est ignorée pour les contrôles synchrones.

Fonctionnalité

Il peut s’agir d’une combinaison de KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF, de KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON ou de KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION. Ce champ doit signaler au moins une fonctionnalité. Le champ doit indiquer KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON , KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION ou les deux. La valeur KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF est facultative.

Indicateurs

Doit être l’un des indicateurs signalés dans La fonctionnalité. La valeur par défaut doit être KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON ou KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION.

Le tableau ci-dessous contient les descriptions et la configuration requise pour les champs de structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING lors de l’utilisation du contrôle de mode torche IR.

Membre Description

Mode

Inutilisé. Doit être égal à 0.

Min/Max/Step

La valeur Min/Max/Step contient la valeur minimale/maximale/incrémentée des paramètres d’alimentation ir. Le pilote doit les retourner pour les opérations GET. (Max – Min) doit être uniformément divisible par étape. L’étape peut ne pas être égale à zéro (0).

VideoProc

Pour les opérations SET, VideoProc.Value.ul doit spécifier le niveau d’alimentation dans la plage décrite par le paramètre Min/Max/Step. Pour les opérations GET, le pilote doit retourner le niveau d’alimentation actuel.

Réservé

Inutilisé. Doit être ignoré par le pilote.

Configuration requise

En-tête

 Ksmedia.h