структура KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING (ksmedia.h)

  • Статья

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING — это структура полезных данных свойств для параметров обработки видео, связанных с балансом белого, режимом экспозиции и режимом фокусировки.

Синтаксис

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;

Члены

Mode

Тип режима обработки видео. В настоящее время этот элемент используется для управления балансом белого. Ниже приведены возможные значения параметра Mode .

Значение Описание
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE Значение температуры изображения используется для установки баланса белого в градусах Кельвина.
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET Параметр баланса белого — это предустановленное значение, указанное в VideoProc.

Этот элемент не используется для KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE и KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE. В таких случаях ему необходимо присвоить значение 0.

Min

Минимальное значение диапазона для параметра в VideoProc.

Max

Максимальное значение диапазона для параметра в VideoProc.

Step

Значение приращения, если применимо, для параметра в VideoProc , если для параметра Mode задано значение KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE.

-или-

Значение приращения , если применимо, для параметра в VideoProc при настройке экспозиции устанавливается вручную с помощью KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

VideoProc

При использовании свойства KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE , если для параметра Mode задано значение KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET, значение VideoProc.Value.ul является одним из следующих значений.

Значение Описание
KSCAMERA_EXTENDEDPROP_WBPRESET_CLOUDY Предустановка баланса белого для облачных условий.
KSCAMERA_EXTENDEDPROP_WBPRESET_DAYLIGHT Предустановленный баланс белого для облачного дневного света.
KSCAMERA_EXTENDEDPROP_WBPRESET_FLASH Предустановка баланса белого для компенсации вспышки освещения.
KSCAMERA_EXTENDEDPROP_WBPRESET_FLUORESCENT Предустановка баланса белого для компенсации флуоресцентного освещения.
KSCAMERA_EXTENDEDPROP_WBPRESET_TUNGSTEN Предустановка баланса белого для компенсации освещения, излучаемого вольфрамом.
KSCAMERA_EXTENDEDPROP_WBPRESET_CANDLELIGHT Предустановка баланса белого для компенсации освещения при свечах.

При использовании свойства KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE , если для параметра Mode задано значение KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE, значение VideoProc.Value.ul является значением температуры в градусах Кельвина.

При использовании свойства KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE при использовании для установки экспозиции вручную KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL значение VideoProc.Value.ul — это время экспозиции в 100 единицах наносекунд.

Используя свойство KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE , этот элемент содержит значение фокусного расстояния для режима фокусировки вручную, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

Reserved

Зарезервировано.

Требования

Требование Значение
Минимальная версия клиента Доступно, начиная с Windows 8.1.
Верхняя часть ksmedia.h (включая Ksmedia.h)

См. также раздел

KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE

KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE

KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE