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