IGraphBuilder::RenderFile-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 RenderFile
-Methode erstellt ein Filterdiagramm, das die angegebene Datei rendert.
HRESULT RenderFile(
[in] LPCWSTR lpcwstrFile,
[in] LPCWSTR lpcwstrPlayList
);
[in] lpcwstrFile
Gibt eine Breitzeichenzeichenfolge an, die den Namen einer Mediendatei enthält.
[in] lpcwstrPlayList
Reserviert. Muss NULL sein.
Gibt ein HRESULT zurück. Die folgenden Werte sind möglich.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Erfolg. |
|
Teilerfolg; die Audiowiedergabe wurde nicht gerendert. |
|
Erfolg; Der Filtergraph-Manager hat den Filternamen geändert, um Duplizierungen zu vermeiden. |
|
Einige der Streams in diesem Film haben ein nicht unterstütztes Format. |
|
Teilerfolg; einige Der Streams in diesem Film sind in einem nicht unterstützten Format. |
|
Der Vorgang wurde abgebrochen. |
|
Fehler. |
|
Das Argument ist ungültig. |
|
Nicht genügend Arbeitsspeicher. |
|
NULL-Zeigerargument. |
|
Es konnte keine Kombination von Zwischenfiltern gefunden werden, um die Verbindung herzustellen. |
|
Der Quellfilter für diese Datei konnte nicht geladen werden. |
|
Es wurde keine Kombination von Filtern gefunden, um den Stream zu rendern. |
|
Das Dateiformat ist ungültig. |
|
Ein Objekt oder Name wurde nicht gefunden. |
|
Der Medientyp dieser Datei wird nicht erkannt. |
|
Die Datei kann nicht wiedergegeben werden. Das Format wird nicht unterstützt. |
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.
Im folgenden Beispiel wird eine AVI-Datei für die Standardwiedergabe gerendert:
C++ |
---|
hr = pGraph->RenderFile(L"C:\\Media\\Example.avi", 0); |
C++ |
---|
hr = pGraph->RenderFile(L"http://example.microsoft.com/Example.avi", 0); |
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 |