KSPROPERTY_CAMERACONTROL_AUTO_EXPOSURE_PRIORITY

The KSPROPERTY_CAMERACONTROL_AUTO_EXPOSURE_PRIORITY property specifies whether the device can dynamically vary the frame rate.

Usage Summary Table

GetSetTargetProperty descriptor typeProperty value type

Yes

Yes

Filter or node

KSPROPERTY_CAMERACONTROL_S, KSPROPERTY_CAMERACONTROL_NODE_S

ULONG

 

The property value (operation data) is a ULONG that specifies whether frame rate can be dynamically varied by the device.

ValueDescription

0

Frame rate must remain constant.

1

Frame rate can be dynamically varied by the device.

 

Remarks

Auto-exposure priority determines whether the camera can dynamically vary the frame rate depending on lighting conditions.

Without auto-exposure, for instance, if the frame rate is 30 fps, the exposure time cannot exceed 33 ms.

With auto-exposure priority, however, the camera could compensate for low lighting by decreasing the frame rate. For instance, the camera could reduce frame rate to 25 fps, thereby lengthening exposure time to 40 ms.

KSPROPERTY_CAMERACONTROL_AUTO_EXPOSURE_PRIORITY maps to the Low-Light Compensation check box on the USB Video Class property page.

In order to use KSPROPERTY_CAMERACONTROL_AUTO_EXPOSURE_PRIORITY, you must set KSPROPERTY_CAMERACONTROL_EXPOSURE to auto. In other words, the camera must be in auto-exposure mode for the auto-exposure-priority mode to be a valid option.

The default value for KSPROPERTY_CAMERACONTROL_AUTO_EXPOSURE_PRIORITY is zero.

Requirements

Version

Available for Windows Vista and later versions of the Windows operating system.

Header

Ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY_CAMERACONTROL_S
KSPROPERTY_CAMERACONTROL_NODE_S

 

 

Send comments about this topic to Microsoft

Show: