ICameraControl interface (vidcap.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The ICameraControl interface controls the camera settings on a capture device.

This interface may be exposed by one or more nodes in a capture filter. It is not exposed at the level of the filter itself. To enumerate the nodes, query the filter for the IKsTopologyInfo interface. For each node, call IKsTopologyInfo::get_NodeType to get the node type. The ICameraControl interface is exposed by nodes of type KSNODETYPE_VIDEO_CAMERA_TERMINAL. Get the interface pointer by calling IKsTopologyInfo::CreateNodeInstance with the value IID_ICameraControl.

This interface corresponds to the PROPSETID_VIDCAP_CAMERACONTROL property set, which is documented in the Windows DDK.

Inheritance

The ICameraControl interface inherits from the IUnknown interface. ICameraControl also has these types of members:

Methods

The ICameraControl interface has these methods.

 
ICameraControl::get_Exposure

The get_Exposure method returns the camera's exposure time.
ICameraControl::get_ExposureRelative

The get_ExposureRelative method returns the camera's relative exposure time. The relative exposure time is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::get_FocalLengths

The get_FocalLengths method returns the focal lengths of the camera lenses.
ICameraControl::get_Focus

The get_Focus method returns the distance that is optimally in focus.
ICameraControl::get_FocusRelative

The get_FocusRelative method returns the relative focus. The relative focus indicates the direction in which the lens group is moving.
ICameraControl::get_Iris

The get_Iris method returns the camera's aperture setting.
ICameraControl::get_IrisRelative

The get_IrisRelative method returns the camera's relative aperture setting. The relative aperture is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::get_Pan

The get_Pan method returns the camera's panning angle.
ICameraControl::get_PanRelative

The get_PanRelative method returns the camera's relative pan. The relative pan is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::get_PanTilt

The get_PanTilt method returns the camera's pan and tilt angles.
ICameraControl::get_PanTiltRelative

The get_PanTiltRelative method returns the camera's relative pan and tilt. The relative pan and tilt are expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::get_PrivacyMode

.
ICameraControl::get_Roll

.
ICameraControl::get_RollRelative

The get_RollRelative method returns the camera's relative roll. The relative roll is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::get_ScanMode

The get_ScanMode method returns the current scanning mode (interlaced or progressive).
ICameraControl::get_Tilt

The get_Tilt method returns the camera's tilt angle.
ICameraControl::get_TiltRelative

This topic applies only to Windows XP Service Pack 2 and later.
ICameraControl::get_Zoom

The get_Zoom method returns the camera's optical zoom level.
ICameraControl::get_ZoomRelative

The get_ZoomRelative method returns the camera's relative zoom. The relative zoom indicates the direction in which the lens is moving.
ICameraControl::getRange_Exposure

The getRange_Exposure method returns the range of exposure times supported by the camera.
ICameraControl::getRange_ExposureRelative

The getRange_ExposureRelative method returns the range of relative exposure times supported by the camera. The relative exposure time is expressed as a number of steps, where the absolute value of each step depends on the camera model.
ICameraControl::getRange_Focus

The getRange_Focus method returns the range of focal distances supported by the camera.
ICameraControl::getRange_FocusRelative

The getRange_FocusRelative method returns the range of relative focal distances supported by the camera. The relative focus indicates the direction in which the lens group is moving.
ICameraControl::getRange_Iris

The getRange_Iris method returns the range of aperture settings supported by the camera.
ICameraControl::getRange_IrisRelative

The getRange_IrisRelative method returns the range of relative aperture settings supported by the camera. The relative aperture is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::getRange_Pan

The getRange_Pan method returns the range of panning angles supported by the camera.
ICameraControl::getRange_PanRelative

The getRange_PanRelative method returns the range of relative panning angles supported by the camera. The relative pan is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::getRange_Roll

The getRange_Roll method returns the range of roll angles supported by the camera.
ICameraControl::getRange_RollRelative

The getRange_RollRelative method returns the range of relative roll angles supported by the camera. The relative roll is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::getRange_Tilt

The getRange_Tilt method returns the range of tilt angles supported by the camera.
ICameraControl::getRange_TiltRelative

The getRange_TiltRelative method returns the range of relative tilt angles supported by the camera. The relative tilt is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::getRange_Zoom

The getRange_Zoom method returns the range of zoom levels supported by the camera.
ICameraControl::getRange_ZoomRelative

The getRange_ZoomRelative method returns the range of relative zoom levels supported by the camera. The relative zoom indicates the direction in which the lens is moving.
ICameraControl::put_Exposure

The put_Exposure method sets the camera's exposure time.
ICameraControl::put_ExposureRelative

The put_ExposureRelative method sets the camera's relative exposure time. The relative exposure time is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::put_Focus

The put_Focus method sets the distance that is optimally in focus.
ICameraControl::put_FocusRelative

The put_FocusRelative method sets the relative focus. The relative focus indicates the direction in which the lens group is moving.
ICameraControl::put_Iris

The put_Iris method sets the camera's aperture setting.
ICameraControl::put_IrisRelative

The put_IrisRelative method sets the camera's relative aperture setting. The relative aperture is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::put_Pan

The put_Pan method sets the camera's panning angle.
ICameraControl::put_PanRelative

The put_PanRelative method sets the camera's relative pan. The relative pan is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::put_PanTilt

The put_PanTilt method sets the camera's pan and tilt angles.
ICameraControl::put_PanTiltRelative

The put_PanTiltRelative method sets the camera's relative pan and tilt. The relative pan and tilt are expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::put_PrivacyMode

The put_PrivacyMode method sets the camera's privacy setting. The privacy setting controls whether the camera sensor captures video.
ICameraControl::put_Roll

The put_Roll method sets the camera's roll angle.
ICameraControl::put_RollRelative

The put_RollRelative method sets the camera's relative roll. The relative roll is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::put_ScanMode

The put_ScanMode method sets the camera's scanning mode (interlaced or progressive).
ICameraControl::put_Tilt

The put_Tilt method sets the camera's tilt angle.
ICameraControl::put_TiltRelative

The put_TiltRelative method sets the camera's relative tilt. The relative tilt is expressed as a number of steps, where the size of each step depends on the camera model.
ICameraControl::put_Zoom

The put_Zoom method sets the camera's zoom level.
ICameraControl::put_ZoomRelative

The put_ZoomRelative method sets the camera's relative zoom. The relative zoom indicates the direction in which the lens is moving.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header vidcap.h