Développer Réduire

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING structure

The KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING is a property payload structure for video processing settings related to white balance, exposure mode, and focus mode.

Syntax


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

Members

Mode

The video processing mode type. Currently, this member is used to control white balance. The possible values for Mode are the following.

ValueMeaning
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE

A picture temperature value is used to set white balance in degrees Kelvin.

KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET

The white balance setting is a preset value specified in VideoProc.

 

This member is not used for KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE and KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE. In these cases it must be set to 0.

Min

The minum range value for the setting in VideoProc.

Max

The maximum range value for the setting in VideoProc.

Step

The maximum range value for the setting in VideoProc.

The increment in value, when applicable, for the setting in VideoProc when Mode is set to KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE.

-or-

The increment in value, when applicable, for the setting in VideoProc when setting exposure is set manually with KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

VideoProc

Using the KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE property, when Mode is set to KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET, the VideoProc.Value.ul value is one of the following.

ValueMeaning
KSCAMERA_EXTENDEDPROP_WBPRESET_CLOUDY

White balance preset for cloudy conditions.

KSCAMERA_EXTENDEDPROP_WBPRESET_DAYLIGHT

White balance preset for cloudy daylight.

KSCAMERA_EXTENDEDPROP_WBPRESET_FLASH

White balance preset to compensate for flash lighting.

KSCAMERA_EXTENDEDPROP_WBPRESET_FLUORESCENT

White balance preset to compensate for fluorescent lighting.

KSCAMERA_EXTENDEDPROP_WBPRESET_TUNGSTEN

White balance preset to compensate for tungsten emitted lighting.

KSCAMERA_EXTENDEDPROP_WBPRESET_CANDLELIGHT

White balance preset to compensate for candlelight lighting.

 

Using the KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE property, when Mode is set to KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE, the VideoProc.Value.ul value is a temperature value in degrees Kelvin.

Using the KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE property, when used for manually setting exposure, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL, the VideoProc.Value.ul value is a the exposure time in 100 nanosecond units.

Using the KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE property, this member contains the focal length value for manual focus mode, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

Reserved

Reserved.

Requirements

Version

Available starting with Windows 8.1.

Header

Ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE
KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE
KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE

 

 

Send comments about this topic to Microsoft

Afficher:
© 2014 Microsoft