IGraphBuilder::RenderFile-Methode (strmif.h)

  • Artikel

[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