IGraphBuilder::RenderFile-Methode (strmif.h)

Artikel
03/04/2024

[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 RenderFile -Methode erstellt ein Filterdiagramm, das die angegebene Datei rendert.

Syntax

HRESULT RenderFile(
  [in] LPCWSTR lpcwstrFile,
  [in] LPCWSTR lpcwstrPlayList
);

Parameter

[in] lpcwstrFile

Gibt eine Breitzeichenzeichenfolge an, die den Namen einer Mediendatei enthält.

[in] lpcwstrPlayList

Reserviert. Muss NULL sein.

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 den Filternamen geändert, um Duplizierungen zu vermeiden.
VFW_S_PARTIAL_RENDER	Einige der Streams in diesem Film haben ein nicht unterstütztes Format.
VFW_S_VIDEO_NOT_RENDERED	Teilerfolg; einige Der Streams in diesem Film sind in einem nicht unterstützten Format.
E_ABORT	Der Vorgang wurde abgebrochen.
E_FAIL	Fehler.
E_INVALIDARG	Das Argument ist ungültig.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
E_POINTER	NULL-Zeigerargument.
VFW_E_CANNOT_CONNECT	Es konnte keine Kombination von Zwischenfiltern gefunden werden, um die Verbindung herzustellen.
VFW_E_CANNOT_LOAD_SOURCE_FILTER	Der Quellfilter für diese Datei konnte nicht geladen werden.
VFW_E_CANNOT_RENDER	Es wurde keine Kombination von Filtern gefunden, um den Stream zu rendern.
VFW_E_INVALID_FILE_FORMAT	Das Dateiformat ist ungültig.
VFW_E_NOT_FOUND	Ein Objekt oder Name wurde nicht gefunden.
VFW_E_UNKNOWN_FILE_TYPE	Der Medientyp dieser Datei wird nicht erkannt.
VFW_E_UNSUPPORTED_STREAM	Die Datei kann nicht wiedergegeben werden. Das Format wird nicht unterstützt.

Hinweise

Wenn der lpwstrFile-Parameter eine Mediendatei angibt, erstellt die Methode ein Filterdiagramm für die Standardwiedergabe. Zunächst wird ein Quellfilter hinzugefügt, der die Datei lesen kann, wobei derselbe Prozess wie die IGraphBuilder::AddSourceFilter-Methode verwendet wird. Anschließend werden die Ausgabepins für den Quellfilter gerendert und bei Bedarf Zwischenfilter hinzugefügt. Sie versucht Filter in der gleichen Reihenfolge wie die IGraphBuilder::Connect-Methode .

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.

Beachten Sie, dass die RenderFile Methode keine Filter aus dem Diagramm entfernt. Wenn Sie zweimal aufrufen RenderFile , fügt der zweite Aufruf dem Diagramm einfach weitere Filter hinzu. Wenn Sie das Diagramm ausführen, werden beide Quellen gleichzeitig wiedergegeben.

Beispiele

Im folgenden Beispiel wird eine AVI-Datei für die Standardwiedergabe gerendert:

C++
hr = pGraph->RenderFile(L"C:\\Media\\Example.avi", 0);

Im folgenden Beispiel wird eine AVI-Datei über HTTP heruntergeladen, wobei der Filter Dateiquelle (URL) verwendet wird:

C++
hr = pGraph->RenderFile(L"http://example.microsoft.com/Example.avi", 0);

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

Freigeben über