ksmedia.h) (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 结构

项目
08/07/2023

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

当 Mode 设置为时，VideoProc 中设置的值增量（如果适用）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

保留。