IVMRFilterConfig::SetImageCompositor-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die SetImageCompositor -Methode installiert einen von der Anwendung bereitgestellten Imagekompositor.

Syntax

HRESULT SetImageCompositor(
  [in] IVMRImageCompositor *lpVMRImgCompositor
);

Parameter

[in] lpVMRImgCompositor

Zeiger auf die IVMRImageCompositor-Schnittstelle des Bildkompositors .

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
VFW_E_WRONG_STATE	Der Mixer ist derzeit nicht geladen.

Hinweise

Verwenden Sie diese Methode, um den Standardkompositor der VMR durch einen benutzerdefinierten Compositor zu ersetzen, der von der Anwendung bereitgestellt wird. Der Bildkompositor ist eine Unterkomponente des Mixers.

Der Compositor wird automatisch geladen, wenn sich die VMR im Fenster- oder Fenstermodus befindet. Wenn sich die VMR im renderlosen Modus befindet, muss der Compositor geladen werden, indem IVMRFilterConfig::SetNumberOfStreams aufgerufen wird. Die VMR verwaltet alle Verweiszählungen auf der IVMRImageCompositor-Schnittstelle .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IVMRFilterConfig-Schnittstelle

Verwenden des Videomischrenderers