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
| 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 |