IVMRImageCompositor::CompositeImage-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die CompositeImage
-Methode zusammengesetzt die aktuellen Frames, die in jedem Eingabedatenstrom verfügbar sind.
Syntax
HRESULT CompositeImage(
[in] IUnknown *pD3DDevice,
[in] LPDIRECTDRAWSURFACE7 pddsRenderTarget,
[in] AM_MEDIA_TYPE *pmtRenderTarget,
[in] REFERENCE_TIME rtStart,
[in] REFERENCE_TIME rtEnd,
[in] DWORD dwClrBkGnd,
[in] VMRVIDEOSTREAMINFO *pVideoStreamInfo,
[in] UINT cStreams
);
Parameter
[in] pD3DDevice
Zeiger auf die IUnknown-Schnittstelle des Direct3D-Geräts. Der Compositor muss diesen in einen LPDIRECT3DDEVICE7-Typ umwandeln.
[in] pddsRenderTarget
Gibt die DirectDraw-Oberfläche an, auf der die gesamte Zeichnung ausgeführt werden soll.
[in] pmtRenderTarget
Gibt den Medientyp der DirectDraw-Oberfläche an.
[in] rtStart
Gibt die Startzeit an.
[in] rtEnd
Gibt die Endzeit an.
[in] dwClrBkGnd
Gibt die Hintergrundfarbe an.
[in] pVideoStreamInfo
Zeiger auf ein Array von Videostream-Infoobjekten.
[in] cStreams
Gibt die Anzahl der zu mischenden Streams an, die der Größe des pVideoStreamInfo-Arrays entspricht.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
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 |