Hardware Dev Center

KSPROPERTY_CAMERACONTROL_PANTILT_RELATIVE

The KSPROPERTY_CAMERACONTROL_PANTILT_RELATIVE property specifies horizontal or vertical rotation of the camera and can specify both simultaneously.

Usage Summary Table

GetSetTargetProperty descriptor typeProperty value type

Yes

Yes

Filter or node

KSPROPERTY_CAMERACONTROL_NODE_S2 or KSPROPERTY_CAMERACONTROL_S2 depending on whether the request is for a filter or a node

Pair of LONG integers

 

The property value (operation data) is a pair of LONG integers that specify a camera's relative pan and tilt settings. The size of the value represents the desired pan speed; a higher value represents a higher speed.

Value1Description

0

Stop the horizontal motion of the camera.

Positive value

Start panning to the right.

Negative value

Start panning to the left.

 

The size of the value represents the desired tilt speed; a higher value represents a higher speed.

Value2Description

0

Stop the vertical motion of the camera.

Positive value

Start rotating the camera up.

Negative value

Start rotating the camera down.

 

Remarks

When making a set request to pan the camera, the client should supply one of the values in the preceding table in Value1 member of the property descriptor structure.

Similarly, when making a set request to tilt the camera, the client supplies one of the values in the preceding table in Value2 member of the property descriptor structure.

When making a get request, the client receives the pan value in the Value1 member and the tilt value in the Value2 member of the KSPROPERTY_CAMERACONTROL_S2 or KSPROPERTY_CAMERACONTROL_NODE_S2 structure. The values indicate the current pan or tilt status of the camera.

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

Requirements

Version

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

Header

Ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY_CAMERACONTROL_S2
KSPROPERTY_CAMERACONTROL_NODE_S2

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft