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 |