KSPROPERTY_CAMERACONTROL_ROLL_RELATIVE

The KSPROPERTY_CAMERACONTROL_ROLL_RELATIVE property specifies camera rotation around the image viewing axis.

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 relative roll setting. The size of the value represents the desired rotation speed; a higher value represents a higher speed.

ValueDescription

0

Stop the roll.

Positive value

Start rotating clockwise around the viewing axis.

Negative value

Start rotating counterclockwise around the viewing axis.

 

Remarks

The Value member of the KSPROPERTY_CAMERACONTROL_NODE_S structure specifies the relative roll.

Note that a particular device might support only a certain speed range. To determine the range of speeds supported by the device, an application can issue a KSPROPERTY_TYPE_BASICSUPPORT request. You can specify KSPROPERTY_TYPE_BASICSUPPORT in the Flags member of the KSPROPERTY_ITEM structure.

Some devices support only a single rotation speed. In this case, the sign of the Value member indicates the direction of rotation.

When making a set request, the client should supply one of the values in the preceding table in the Value member of the KSPROPERTY_CAMERACONTROL_NODE_S structure.

When making a get request, the client receives one of the values in the preceding table in the Value member of the KSPROPERTY_CAMERACONTROL_NODE_S structure. The value indicates the current rotation status of the camera.

Requirements

Version

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

Header

Ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY_CAMERACONTROL_NODE_S

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft