IMFMediaEngineEx::InsertVideoEffect-Methode (mfmediaengine.h)

  • Artikel

Fügt einen Videoeffekt ein.

Syntax

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

Parameter

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

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

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

Hinweise

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

Anforderungen

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

Weitere Informationen

IMFMediaEngineEx