KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING structure (ksmedia.h)
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 tagKSCAMERA_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.
| Value | Description |
|---|---|
| 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 minimum range value for the setting in VideoProc.
Max
The maximum range value for the setting in VideoProc.
Step
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.
| Value | Description |
|---|---|
| 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 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
| Requirement | Value |
|---|---|
| Minimum supported client | Available starting with Windows 8.1. |
| Header | ksmedia.h (include Ksmedia.h) |
See also
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE