KSPROPERTY_CAMERACONTROL_ROLL

User-mode clients use the KSPROPERTY_CAMERACONTROL_ROLL property to get or set a camera's roll setting. This property is optional.

Usage Summary Table

Get Set Target Property descriptor type Property value type
Yes Yes Filter or node KSPROPERTY_CAMERACONTROL_S or KSPROPERTY_CAMERACONTROL_NODE_S LONG

The property value (operation data) is a LONG that specifies a camera's roll setting. This value is expressed in degrees.

Positive values cause a clockwise rotation of the camera along the image-viewing axis. Negative values cause a counterclockwise rotation of the camera, as shown in the following illustration.

illustration showing camera roll values.

Every video capture minidriver that supports this property must define a range and default value for this property. The range for the device must be -180 through +180 and the default value must be 0.

Remarks

The Value member of the KSPROPERTY_CAMERACONTROL_S structure specifies the roll setting.

Requirements

Header: ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY

KSPROPERTY_CAMERACONTROL_S