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 |