IFilterGraph2::RenderEx-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 RenderEx -Methode rendert einen Ausgabenadel mit einer Option, nur vorhandene Renderer zu verwenden.

Syntax

HRESULT RenderEx(
  [in]      IPin  *pPinOut,
  [in]      DWORD dwFlags,
  [in, out] DWORD *pvContext
);

Parameter

[in] pPinOut

Zeiger auf die IPin-Schnittstelle des Ausgabepins.

[in] dwFlags

Flag, das angibt, wie der Pin gerendert werden soll. Wenn der Wert AM_RENDEREX_RENDERTOEXISTINGRENDERERS ist, versucht die Methode, Renderer zu verwenden, die bereits im Filterdiagramm enthalten sind. Dem Diagramm werden keine neuen Renderer hinzugefügt. (Bei Bedarf werden zwischengeschaltete Transformationsfilter hinzugefügt.) Damit die Methode erfolgreich ist, muss das Diagramm die entsprechenden Renderer enthalten, und sie müssen über nicht verbundene Eingabenadeln verfügen. Wenn der Wert 0 ist, verhält sich die Methode identisch mit der IGraphBuilder::Render-Methode .

[in, out] pvContext

Reserviert. Muss NULL sein.

Rückgabewert

Gibt ein HRESULT zurück.

Anforderungen

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

Weitere Informationen

Fehler- und Erfolgscodes

IFilterGraph2-Schnittstelle