Freigeben über

IGraphBuilder::Render-Methode (strmif.h)

  • Artikel

[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 Render -Methode erstellt ein Filterdiagramm, das die Daten von einem angegebenen Ausgabenadel rendert.

Syntax

HRESULT Render(
  [in] IPin *ppinOut
);

Parameter

[in] ppinOut

Zeiger auf die IPin-Schnittstelle an einem Ausgabepin.

Rückgabewert

Gibt ein HRESULT zurück. Die folgenden Werte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
VFW_S_AUDIO_NOT_RENDERED
 Teilerfolg; Die Audiowiedergabe wurde nicht gerendert.
VFW_S_DUPLICATE_NAME
 Erfolg; Der Filtergraph-Manager hat einen Filternamen geändert, um Duplizierungen zu vermeiden.
VFW_S_PARTIAL_RENDER
 Teilerfolg; Einige der Streams in diesem Film haben ein nicht unterstütztes Format.
VFW_S_VIDEO_NOT_RENDERED
 Teilerfolg; Das Video wurde nicht gerendert.
E_ABORT
 Der Vorgang wurde abgebrochen.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.
E_POINTER
 NULL-Zeigerargument.
VFW_E_CANNOT_CONNECT
 Es wurde keine Kombination von Zwischenfiltern gefunden, um die Verbindung herzustellen.
VFW_E_CANNOT_RENDER
 Es wurde keine Kombination von Filtern gefunden, um den Stream zu rendern.
VFW_E_NO_ACCEPTABLE_TYPES
 Es gibt keinen gemeinsamen Medientyp zwischen diesen Pins.
VFW_E_NOT_IN_GRAPH
 Der Filter, zu dem dieser Pin gehört, befindet sich nicht im Filterdiagramm.

Hinweise

Diese Methode rendert die Daten von einem angegebenen Ausgabenadel und fügt dem Diagramm nach Bedarf neue Filter hinzu. Filter werden in der gleichen Reihenfolge wie für die IGraphBuilder::Connect-Methode ausprobiert. Weitere Informationen finden Sie unter Intelligent Connect.

Während des Verbindungsvorgangs ignoriert der Filtergraph-Manager Pins für Zwischenfilter, wenn der Pinname mit einer Tilde (~) beginnt. Weitere Informationen finden Sie unter PIN_INFO.

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

IGraphBuilder-Schnittstelle