IDvdGraphBuilder::RenderDvdVideoVolume-Methode (strmif.h)

Artikel
03/02/2024

[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 RenderDvdVideoVolume -Methode schließt die Erstellung eines Filterdiagramms gemäß den Benutzerspezifikationen für die Wiedergabe eines DVD-Video-Volumes ab.

Syntax

HRESULT RenderDvdVideoVolume(
  [in]  LPCWSTR             lpcwszPathName,
  [in]  DWORD               dwFlags,
  [out] AM_DVD_RENDERSTATUS *pStatus
);

Parameter

[in] lpcwszPathName

Zeiger auf den Pfad für das DVD-Video Volume, das wiedergegeben werden soll. Kann NULL sein.

[in] dwFlags

Bitweises OR von Flags aus AM_DVD_GRAPH_FLAGS Enumeration, die angeben, wie das DVD-Wiedergabediagramm erstellt wird.

[out] pStatus

Zeiger auf eine AM_DVD_RENDERSTATUS-Struktur . Wenn die -Methode zurückgegeben wird, gibt die -Struktur alle Renderingfehler an.

Rückgabewert

Gibt einen HRESULT-Wert zurück, der von der Implementierung der Schnittstelle abhängt. Die Rückgabewerte der DirectShow-Implementierung umfassen Folgendes:

Rückgabecode	Beschreibung
E_INVALIDARG	Der dwFlags-Parameter gibt in Konflikt stehende Optionen an.
S_FALSE	Die -Methode war teilweise erfolgreich. Überprüfen Sie den pStatus-Parameter , um herauszufinden, welche Fehler aufgetreten sind.
S_OK	Die Methode war erfolgreich, und alle Streams wurden gerendert.
VFW_E_DVD_DECNOTENOUGH	Mindestens ein Datenstrom konnte nicht gerendert werden. Wenn Sie das AM_DVD_HWDEC_ONLY- oder AM_DVD_SWDEC_ONLY-Flag im dwFlags-Parameter angegeben haben, versuchen Sie erneut, die Methode mit dem AM_DVD_HWDEC_PREFER- oder AM_DVD_SWDEC_PREFER-Flag aufzurufen.
VFW_E_DVD_NON_EVR_RENDERER_IN_FILTER_GRAPH	Das Filterdiagramm enthält bereits einen Videorenderer. Die -Methode gibt diesen Fehlercode zurück, wenn Sie das AM_DVD_EVR_ONLY-Flag im dwFlags-Parameter angeben, der Graph jedoch bereits einen anderen Videorenderer als den Filter "Enhanced Video Renderer" (VMR) enthält.
VFW_E_DVD_RENDERFAIL	Fehler beim Erstellen des Graphen. Beispielsweise konnte der DVD Graph Builder keinen erforderlichen Filter erstellen oder keine der Streams rendern.
VFW_E_DVD_TOO_MANY_RENDERERS_IN_FILTER_GRAPH	Das Filterdiagramm enthält mehr als einen Videorenderer.

Hinweise

Die AM_DVD_RENDERSTATUS-Struktur spiegelt Fehlercodes für diese Methode wider. Gründe für die Rückgabe dieser Methode S_FALSE sind die folgenden:

Der Graph wurde vollständig erstellt, aber einer der folgenden Punkte trifft zu.
- Die Überlagerungsmischung funktioniert nicht. Die Anwendung hat das AM_DVD_NOVPE-Flag nicht festgelegt, und der Videodatenstrom konnte nicht über den Überlagerungsmixer platziert werden. Wenn das Video in der Software decodiert ist, verfügt die Anwendung in diesem Fall über genügend Informationen, um den Benutzer darüber zu informieren, dass das Video nicht sichtbar ist. Hardwaredekodierte Videos sind nur auf einem Fernseher sichtbar, der mit dem NTSC-Ausgang des Hardware-Videodecoders verbunden ist.
- Der Videodecoder erzeugt keine Daten der Zeile 21. Die Anwendung kann eine Warnung oder eine informative Meldung anzeigen, dass Untertitel aufgrund des Decoders nicht verfügbar sind.
- Es wurde kein Volumepfad angegeben, und der DVD-Navigator hat keine DVD-Video volume gefunden, die wiedergegeben werden soll. Die Anwendung kann den Benutzer auffordern, eine DVD-Video Disc einzufügen, wenn keine auf dem Laufwerk verfügbar ist, wenn die Wiedergabe gestartet wird.
Einige Streams wurden nicht gerendert. Die Anwendung kann dem Benutzer mitteilen, dass einige Streams nicht wiedergegeben werden können.

Mit dieser Methode wird der Graph ohne Kenntnis der DVD-Video wiedergegebenen Datei oder des Volumes erstellt. Der DVD-Video Graph-Generator erstellt den Graphen auch dann, wenn lpcwszPathNameNULL ist oder wenn der DVD-Navigator-Filter keine standard-DVD-Video Volume für die Wiedergabe findet.

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

DVD-Anwendungen

Fehler- und Erfolgscodes

IDvdGraphBuilder-Schnittstelle

Freigeben über