KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION

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

Usage Summary Table

GetSetTargetProperty descriptor typeProperty 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 steppingDescription
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.

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.

MemberValue
Version1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Size

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_EVCOMPENSATION)

Result0
CapabilityStepping flags supported by the driver.
FlagsThe 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)

See also

KSCAMERA_EXTENDEDPROP_HEADER
KSCAMERA_EXTENDEDPROP_EVCOMPENSATION

 

 

Send comments about this topic to Microsoft

显示:
© 2014 Microsoft