IAMVideoProcAmp::Set method (strmif.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 Set method sets video quality for a specified property.

Syntax

HRESULT Set(
  [in] long Property,
  [in] long lValue,
  [in] long Flags
);

Parameters

[in] Property

The property to set, specified as a VideoProcAmpProperty enumeration value.

[in] lValue

The new value of the property.

[in] Flags

The desired control setting, specified as a VideoProcAmpFlags enumeration value.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If the Flags parameter is VideoProcAmp_Flags_Auto, the lValue parameter is ignored, as long as it's between the minimum and maximum values of the property.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)
Library Strmiids.lib

See also

Configure the Video Quality

Error and Success Codes

IAMVideoProcAmp Interface

IAMVideoProcAmp::Get