Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
IMFMediaEngineEx::InsertVideoEffect method (mfmediaengine.h)
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 |
|---|---|
|
The effect is optional. If the Media Engine cannot add the effect, it ignores the effect and continues playback. |
|
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 |
|---|---|
|
Success. |
|
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
Feedback
Was this page helpful?