IMFMediaEngineEx::InsertVideoEffect-Methode (mfmediaengine.h)

Fügt einen Videoeffekt ein.

Syntax

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

[in] pEffect

Einer der folgenden:

Ein Zeiger auf die IMFTransform-Schnittstelle einer Media Foundation-Transformation (MFT), die den Videoeffekt implementiert.
Ein Zeiger auf die IMFActivate-Schnittstelle eines Aktivierungsobjekts. Das Aktivierungsobjekt muss ein MFT für den Videoeffekt erstellen.

[in] fOptional

Gibt an, ob der Effekt optional ist.

Wert	Bedeutung
STIMMT	Der Effekt ist optional. Wenn die Medien-Engine den Effekt nicht hinzufügen kann, ignoriert sie den Effekt und setzt die Wiedergabe fort.
FALSE	Der Effekt ist erforderlich. Wenn das Medienmodulobjekt den Effekt nicht hinzufügen kann, tritt ein Wiedergabefehler auf.

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
MF_E_INVALIDREQUEST	Die maximale Anzahl von Videoeffekten wurde erreicht.

Der Effekt wird angewendet, wenn die nächste Medienressource geladen wird.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfmediaengine.h