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
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
Yes |
Yes |
Filter |
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) |