Edit

IMFMediaEngineEx::InsertVideoEffect method (mfmediaengine.h)

  • Article

Inserts a video effect.

Syntax

HRESULT InsertVideoEffect(
  [in] IUnknown *pEffect,
  [in] BOOL     fOptional
);

Parameters

[in] pEffect

One of the following:

  • A pointer to the IMFTransform interface of a Media Foundation transform (MFT) that implements the video effect.
  • A pointer to the IMFActivate interface of an activation object. The activation object must create an MFT for the video effect.

[in] fOptional

Specifies whether the effect is optional.

Value Meaning
TRUE
 The effect is optional. If the Media Engine cannot add the effect, it ignores the effect and continues playback.
FALSE
 The effect is required. If the Media Engine object cannot add the effect, a playback error occurs.

Return value

This method can return one of these values.

Return code Description
S_OK
 Success.
MF_E_INVALIDREQUEST
 The maximum number of video effects was reached.

Remarks

The effect is applied when the next media resource is loaded.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header mfmediaengine.h

See also

IMFMediaEngineEx