ICameraControl interface
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.
Methods
The ICameraControl interface has these methods.
| Method | Description |
|---|---|
| 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
| 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 |