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.