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

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

 

 

Send comments about this topic to Microsoft

Show: