Freigeben über


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

Weitere Informationen

Fehler- und Erfolgscodes

IVMRImageCompositor-Schnittstelle

Verwenden des Videomischrenderers