IDvdGraphBuilder::GetDvdInterface-Methode (strmif.h)

  • Artikel

[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 GetDvdInterface-Methode ruft Schnittstellen aus dem DVD-Video Wiedergabegraphen ab, um die Entwicklung DVD-Video Wiedergabe zu vereinfachen.

Syntax

HRESULT GetDvdInterface(
  [in]  REFIID riid,
  [out] void   **ppvIF
);

Parameter

[in] riid

IID der angeforderten Schnittstelle.

[out] ppvIF

Empfängt einen Zeiger auf die Schnittstelle. Die Anwendung muss die Schnittstelle freigeben.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
E_INVALIDARG
 Der ppvIF-Parameter ist ungültig. Dieser Parameter darf nicht NULL sein.
E_NOINTERFACE
 Die angeforderte Schnittstelle konnte nicht zurückgegeben werden.
VFW_E_DVD_GRAPHNOTREADY
 Das Diagramm wurde noch nicht erstellt. Siehe Hinweise.

Hinweise

Sie können diese Methode verwenden, um einen Videorendererfilter auszuwählen und zu konfigurieren, bevor Sie das Filterdiagramm für die DVD-Wiedergabe erstellen. Die folgenden Schnittstellen sind verfügbar:

Wenn Sie GetDvdInterface aufrufen, um eine dieser Schnittstellen abzurufen, bevor Sie das Filterdiagramm erstellen, erstellt der DVD Graph Builder den entsprechenden Videorenderer. Dieser Renderer wird später verwendet, wenn Sie das Diagramm erstellen. Nachdem der Videorenderer ausgewählt wurde, können Sie die Schnittstellen für die anderen Videorenderer nicht mehr abrufen. (Die GetDvdInterface-Methode gibt E_NOINTERFACE zurück.)

Wenn Sie vor dem Erstellen des DVD-Wiedergabediagramms Schnittstellen anfordern, die nicht in der vorherigen Liste enthalten sind, gibt die Methode VFW_E_DVD_GRAPHNOTREADY zurück. Rufen Sie zum Erstellen des DVD-Diagramms IDvdGraphBuilder::RenderDvdVideoVolume auf. Nachdem Sie das Diagramm erstellt haben, können Sie GetDvdInterface verwenden, um einige zusätzliche Schnittstellen abzurufen:

  • IDvdControl (veraltet), IDvdControl2, IDvdInfo (veraltet) und IDvdInfo2 zum Steuern der DVD-Wiedergabe.
  • IVideoWindow, IBasicVideo und IBasicVideo2 , um die Videoeinstellungen nur im Fenstermodus zu steuern.
  • IBasicAudio zum Steuern der Audioeinstellungen.
  • IAMLine21Decoder zum Steuern geschlossener Untertitel Anzeige.
  • IMixerPinConfig und IMixerPinConfig2 , um den ersten Eingabestift des Overlay Mixer-Filters zu konfigurieren, der den primären Videostream bereitstellt. (Um diese Schnittstelle für die anderen Pins auf dem Überlagerungsmixer zu erhalten, auflisten Sie die Pins des Filters, und fragen Sie sie direkt ab.) Neue Anwendungen sollten die Verwendung des Overlay Mixer-Filters vermeiden.
Rufen Sie zum Abrufen anderer Schnittstellen IDvdGraphBuilder::GetFiltergraph auf. Fragen Sie die zurückgegebene IGraphBuilder-Schnittstelle ab, oder verwenden Sie EnumFilters , um die Filter aufzulisten.

Anforderungen

   
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

Siehe auch

DVD-Anwendungen

Fehler- und Erfolgscodes

IDvdGraphBuilder-Schnittstelle