KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION

Article
02/27/2023

The EV Compensation property allows adjustment of exposure control by increments of exposure units or by the Zone system.

Usage Summary Table

Get	Set	Target	Property descriptor type	Property value type
Yes	Yes	Filter	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure and a KSCAMERA_EXTENDEDPROP_EVCOMPENSATION structure.

The total property data size is sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_EVCOMPENSATION). The Size member of KSCAMERA_EXTENDEDPROP_HEADER is set to this total property data size.

The Capability member of KSCAMERA_EXTENDEDPROP_HEADER contains a bitwise OR combination of one or more of the following compensation settings.

EV compensation stepping	Description
KSCAMERA_EXTENDEDPROP_EVCOMP_SIXTHSTEP	EV compensation changes in one sixth (1/6) step of the exposure value.
KSCAMERA_EXTENDEDPROP_EVCOMP_QUARTERSTEP	EV compensation changes in one fourth (1/4) step of the exposure value.
KSCAMERA_EXTENDEDPROP_EVCOMP_THIRDSTEP	EV compensation changes in one third (1/3) step of the exposure value.
KSCAMERA_EXTENDEDPROP_EVCOMP_HALFSTEP	EV compensation changes in one half (1/2) step of the exposure value.
KSCAMERA_EXTENDEDPROP_EVCOMP_FULLSTEP	EV compensation changes in one (1/1) step of the exposure value.

The Flags member of KSCAMERA_EXTENDEDPROP_HEADER contains the current EV compensation stepping for the camera (one value).Drivers are recommended to advertise support for only for the lowest EV compensation step sizes.

This property control is asynchronous and not cancelable.

Remarks

Getting the property

When responding to a KSPROPERTY_TYPE_GET request, the driver sets the members of the KSCAMERA_EXTENDEDPROP_HEADER to the following.

Member	Value
Version	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Size	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_EVCOMPENSATION)
Result	0
Capability	Stepping flags supported by the driver.
Flags	The current stepping value set.

The driver sets the current EV compensation stepping in Flags. The members of KSCAMERA_EXTENDEDPROP_EVCOMPENSATION indicate the current step unit ranges and number of step used in for compensation

Setting the property

When the property is set, a KSPROPERTY_TYPE_SET request, the Flags member of KSCAMERA_EXTENDEDPROP_HEADER will contain the EV compensation stepping to use. The new number of step units used for compensation are set in Value member of KSCAMERA_EXTENDEDPROP_EVCOMPENSATION.

Requirements

Version	Available starting with Windows 8.1.
Header	Ksmedia.h (include Ksmedia.h)