Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 |
|---|---|
|
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. |
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); |
| 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 |