ICameraControl Interface
| Microsoft DirectShow 9.0 |
ICameraControl Interface
This topic applies only to Windows XP Service Pack 2 and later.
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.
In addition to the methods inherited from IUnknown, the ICameraControl interface exposes the following methods.
| Method | Description |
| get_Exposure | Returns the camera's exposure time. |
| get_ExposureRelative | Returns the camera's relative exposure time. |
| get_FocalLengths | Returns the focal lengths of the camera lenses. |
| get_Focus | Returns the distance that is optimally in focus. |
| get_FocusRelative | Returns the relative focus. |
| get_Iris | Returns the camera's aperture setting. |
| get_IrisRelative | Returns the camera's relative aperture setting. |
| get_Pan | Returns the camera's panning angle. |
| get_PanRelative | Returns the camera's relative pan. |
| get_PanTilt | Returns the camera's pan and tilt angles. |
| get_PanTiltRelative | Returns the camera's relative pan and tilt. |
| get_PrivacyMode | Returns the camera's privacy setting. |
| get_Roll | Returns the camera's roll angle. |
| get_RollRelative | Returns the camera's relative roll. |
| get_ScanMode | Returns the current scanning mode (interlaced or progressive). |
| get_Tilt | Returns the camera's tilt angle. |
| get_TiltRelative | Returns the camera's relative tilt. |
| get_Zoom | Returns the camera's zoom level. |
| get_ZoomRelative | Returns the camera's relative zoom. |
| getRange_Exposure | Returns the range of exposure times supported by the camera. |
| getRange_ExposureRelative | Returns the range of relative exposure times supported by the camera. |
| getRange_Focus | Returns the range of focal distances supported by the camera. |
| getRange_FocusRelative | Returns the range of relative focal distances supported by the camera. |
| getRange_Iris | Returns the range of aperture settings supported by the camera. |
| getRange_IrisRelative | Returns the range of relative aperture settings supported by the camera. |
| getRange_Pan | Returns the range of panning angles supported by the camera. |
| getRange_PanRelative | Returns the range of relative panning angles supported by the camera. |
| getRange_Roll | Returns the range of roll angles supported by the camera. |
| getRange_RollRelative | Returns the range of relative roll angles supported by the camera. |
| getRange_Tilt | Returns the range of tilt angles supported by the camera. |
| getRange_TiltRelative | Returns the range of relative tilt angles supported by the camera. |
| getRange_Zoom | Returns the range of zoom levels supported by the camera. |
| getRange_ZoomRelative | Returns the range of relative zoom levels supported by the camera. |
| put_Exposure | Sets the camera's exposure time. |
| put_ExposureRelative | Sets the camera's relative exposure time. |
| put_Focus | Sets the distance that is optimally in focus. |
| put_FocusRelative | Sets the relative focus. |
| put_Iris | Sets the camera's aperture setting. |
| put_IrisRelative | Sets the camera's relative aperture setting. |
| put_Pan | Sets the camera's panning angle. |
| put_PanRelative | Sets the camera's relative pan. |
| put_PanTilt | Sets the camera's pan and tilt angles. |
| put_PanTiltRelative | Sets the camera's relative pan and tilt. |
| put_PrivacyMode | Sets the camera's privacy setting. |
| put_Roll | Sets the camera's roll angle. |
| put_RollRelative | Sets the camera's relative roll. |
| put_ScanMode | Sets the camera's scanning mode (interlaced or progressive). |
| put_Tilt | Sets the camera's tilt angle. |
| put_TiltRelative | Sets the camera's relative tilt. |
| put_Zoom | Sets the camera's zoom level. |
| put_ZoomRelative | Sets the camera's relative zoom. |
Requirements
Header: Include Vidcap.h.
Library: Use Strmiids.lib.