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

视频处理模式类型。 目前,此成员用于控制白平衡。 模式 的可能值如下。

价值 描述
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE 图片温度值用于设置以度为凯尔文的白色平衡。
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET 白平衡设置是在 VideoProc中指定的预设值。

此成员不用于 KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODEKSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE。 在这些情况下,必须将其设置为 0。

Min

VideoProc中设置的最小值。

Max

VideoProc中设置的最大范围值。

Step

模式 设置为KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE时,VideoProc 中的设置的值递增( 如果适用)。

-或-

当使用 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL手动设置曝光时,VideoProc 中的设置的值递增( 如果适用)。

VideoProc

使用 KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE 属性,当 模式 设置为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 属性,当 模式 设置为KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE时,VideoProc.Value.ul 值为 Kelvin 的温度值。

使用 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