IAMVideoProcAmp::Set method (strmif.h)

Article
07/27/2023

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

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