KSPROPERTY_CAMERACONTROL_TILT_RELATIVE

The KSPROPERTY_CAMERACONTROL_TILT_RELATIVE property specifies a camera's vertical tilting status.

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

ValueDescription

0

Stop tilting.

Positive value

Start tilting up.

Negative value

Start tilting down.

 

Remarks

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

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 tilt speed. In this case, the sign of the Value member indicates which direction to tilt.

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 tilt 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: