KSPROPERTY_CAMERACONTROL_TILT

User-mode clients use the KSPROPERTY_CAMERACONTROL_TILT property to get or set a camera's tilt 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 tilt setting. This value is expressed in degrees.

Positive values point the imaging plane up. Negative values point the imaging plane down, as shown in the following illustration.

Illustration showing camera tilt 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 -180 through +180. The default value must be 0.

Caution  When writing or testing an app, you should be aware that in practice, some drivers define a custom range of tilt values and custom step values that might not be based on typical units. Drivers might implement the tilt control either physically or digitally.

Remarks

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

Requirements

Header

Ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY
KSPROPERTY_CAMERACONTROL_S

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft