IMFPMediaPlayer::RemoveEffect-Methode (mfplay.h)

Wichtig Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden. Anwendungen sollten die Mediensitzung für die Wiedergabe verwenden.

 

Entfernt einen Effekt, der mit der IMFPMediaPlayer::InsertEffect-Methode hinzugefügt wurde.

Syntax

HRESULT RemoveEffect(
  [in] IUnknown *pEffect
);

Parameter

[in] pEffect

Zeiger auf die IUnknown-Schnittstelle des Effektobjekts. Verwenden Sie denselben Zeiger, den Sie an die InsertEffect-Methode übergeben haben.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
MF_E_NOT_FOUND	Der Effekt wurde nicht gefunden.

Hinweise

Die Änderung gilt für das nächste Medienelement, das auf dem Player festgelegt wird. Der Effekt wird nicht aus dem aktuellen Medienelement entfernt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfplay.h

Weitere Informationen

Hinzufügen von Audio- oder Videoeffekten

IMFPMediaPlayer

Verwenden von MFPlay für die Audio-/Videowiedergabe