IVideoProcAmp 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 IVideoProcAmp interface controls the image adjustment (ProcAmp) 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 IVideoProcAmp interface is exposed by nodes of type KSNODETYPE_VIDEO_PROCESSING. Get the interface pointer by calling IKsTopologyInfo::CreateNodeInstance with the value IID_IVideoProcAmp.

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

Inheritance

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

Methods

The IVideoProcAmp interface has these methods.

 
IVideoProcAmp::get_BacklightCompensation

The get_BacklightCompensation method returns the camera's backlight compensation setting.
IVideoProcAmp::get_Brightness

The get_Brightness method returns the camera's brightness setting.
IVideoProcAmp::get_ColorEnable

The get_ColorEnable method returns the camera's color-enable setting.
IVideoProcAmp::get_Contrast

The get_Contrast method returns the camera's contrast setting.
IVideoProcAmp::get_DigitalMultiplier

The get_DigitalMultiplier method returns the camera's digital zoom level.
IVideoProcAmp::get_Gain

The get_Gain method returns the camera's gain setting.
IVideoProcAmp::get_Gamma

The get_Gamma method returns the camera's gamma setting.
IVideoProcAmp::get_Hue

The get_Hue method returns the camera's hue setting.
IVideoProcAmp::get_PowerlineFrequency

The get_PowerlineFrequency method returns the camera's power line frequency setting. This setting enables the camera to perform anti-flicker processing.
IVideoProcAmp::get_Saturation

The get_Saturation method returns the camera's saturation setting.
IVideoProcAmp::get_Sharpness

The get_Sharpness method returns the camera's sharpness setting.
IVideoProcAmp::get_WhiteBalance

The get_WhiteBalance method returns the camera's white balance, specified as a color temperature.
IVideoProcAmp::get_WhiteBalanceComponent

The get_WhiteBalanceComponent method returns the camera's white balance, specified as red and blue component values.
IVideoProcAmp::getRange_BacklightCompensation

The getRange_BacklightCompensation method returns the range of backlight compensation settings supported by the camera.
IVideoProcAmp::getRange_Brightness

The getRange_Brightness method returns the range of brightness settings supported by the camera.
IVideoProcAmp::getRange_ColorEnable

The getRange_ColorEnable method returns the range of color-enable settings supported by the camera.
IVideoProcAmp::getRange_Contrast

The getRange_Contrast method returns the range of contrast settings supported by the camera.
IVideoProcAmp::getRange_DigitalMultiplier

The getRange_DigitalMultiplier method returns the range of digital zoom levels supported by the camera.
IVideoProcAmp::getRange_Gain

The getRange_Gain method returns the range of gain settings supported by the camera.
IVideoProcAmp::getRange_Gamma

The getRange_Gamma method returns the range of gamma settings supported by the camera.
IVideoProcAmp::getRange_Hue

The getRange_Hue method returns the range of hue settings supported by the camera.
IVideoProcAmp::getRange_PowerlineFrequency

The getRange_PowerlineFrequency method returns the range of power line frequency settings supported by the camera.
IVideoProcAmp::getRange_Saturation

The getRange_Saturation method returns the range of saturation settings supported by the camera.
IVideoProcAmp::getRange_Sharpness

The getRange_Sharpness method returns the range of sharpness settings supported by the camera.
IVideoProcAmp::getRange_WhiteBalance

The getRange_WhiteBalance method returns the range of white balance settings supported by the camera, expressed as color temperature.
IVideoProcAmp::getRange_WhiteBalanceComponent

The getRange_WhiteBalanceComponent method returns the range of white balance settings supported by the camera, expressed as red and blue component values.
IVideoProcAmp::put_BacklightCompensation

The put_BacklightCompensation method sets the camera's backlight compensation.
IVideoProcAmp::put_Brightness

The put_Brightness method sets the camera's brightness setting.
IVideoProcAmp::put_ColorEnable

The put_ColorEnable method sets the camera's color-enable setting.
IVideoProcAmp::put_Contrast

The put_Contrast method sets the camera's contrast setting.
IVideoProcAmp::put_DigitalMultiplier

The put_DigitalMultiplier method sets the camera's digital zoom level.
IVideoProcAmp::put_Gain

The put_Gain method sets the camera's gain setting.
IVideoProcAmp::put_Gamma

The put_Gamma method sets the camera's gamma setting.
IVideoProcAmp::put_Hue

The put_Hue method sets the camera's hue setting.
IVideoProcAmp::put_PowerlineFrequency

The put_PowerlineFrequency method sets the camera's power line frequency setting. This setting enables the camera to perform anti-flicker processing.
IVideoProcAmp::put_Saturation

The put_Saturation method sets the camera's saturation setting.
IVideoProcAmp::put_Sharpness

The put_Sharpness method sets the camera's sharpness setting.
IVideoProcAmp::put_WhiteBalance

The put_WhiteBalance method sets the camera's white balance, specified as a color temperature.
IVideoProcAmp::put_WhiteBalanceComponent

The put_WhiteBalanceComponent method sets the camera's white balance, specified as red and blue component values.

Requirements

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