KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING structure (ksmedia.h)

Article
03/30/2024

Le KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING est une structure de charge utile de propriété pour les paramètres de traitement vidéo liés à la balance des blancs, au mode d’exposition et au mode focus.

Syntaxe

typedef struct tagKSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING {
  ULONG                       Mode;
  LONG                        Min;
  LONG                        Max;
  LONG                        Step;
  KSCAMERA_EXTENDEDPROP_VALUE VideoProc;
  ULONGLONG                   Reserved;
} KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING, *PKSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING;

Membres

Mode

Type de mode de traitement vidéo. Actuellement, ce membre est utilisé pour contrôler la balance des blancs. Les valeurs possibles pour Mode sont les suivantes.

Valeur	Description
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE	Une valeur de température d’image est utilisée pour définir la balance des blancs en degrés Kelvin.
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET	Le paramètre de balance des blancs est une valeur prédéfinie spécifiée dans VideoProc.

Ce membre n’est pas utilisé pour KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE et KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE. Dans ce cas, elle doit être définie sur 0.

Min

Valeur de plage minimale pour le paramètre dans VideoProc.

Max

Valeur de plage maximale pour le paramètre dans VideoProc.

Step

Incrémentation de la valeur, le cas échéant, pour le paramètre dans VideoProc lorsque Mode est défini sur KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE.

-ou-

Incrément de la valeur, le cas échéant, pour le paramètre dans VideoProc lorsque la définition de l’exposition est définie manuellement avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

VideoProc

À l’aide de la propriété KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE, lorsque Mode a la valeur KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET, la valeur VideoProc.Value.ul est l’une des suivantes.

Valeur	Description
KSCAMERA_EXTENDEDPROP_WBPRESET_CLOUDY	Préréglage de la balance des blancs pour les conditions nuageux.
KSCAMERA_EXTENDEDPROP_WBPRESET_DAYLIGHT	Équilibre des blancs prédéfini pour la lumière du jour nuageux.
KSCAMERA_EXTENDEDPROP_WBPRESET_FLASH	Préréglage de la balance des blancs pour compenser l’éclairage flash.
KSCAMERA_EXTENDEDPROP_WBPRESET_FLUORESCENT	Équilibre des blancs prédéfini pour compenser l’éclairage fluorescent.
KSCAMERA_EXTENDEDPROP_WBPRESET_TUNGSTEN	Préréglage de la balance des blancs pour compenser l’éclairage émis par le tungstène.
KSCAMERA_EXTENDEDPROP_WBPRESET_CANDLELIGHT	Équilibre des blancs prédéfini pour compenser l’éclairage aux chandelles.

À l’aide de la propriété KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE, lorsque Mode a la valeur KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE, la valeur VideoProc.Value.ul est une valeur de température en degrés Kelvin.

À l’aide de la propriété KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE, lorsqu’elle est utilisée pour définir manuellement l’exposition, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL, la valeur VideoProc.Value.ul correspond au temps d’exposition en unités de 100 nanosecondes.

À l’aide de la propriété KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE, ce membre contient la valeur de longueur focale pour le mode focus manuel, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

Reserved

Réservé.