IGraphBuilder::Connect-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 Connect Methode verbindet die beiden Pins und verwendet bei Bedarf Zwischenschritte.

Syntax

HRESULT Connect(
  [in] IPin *ppinOut,
  [in] IPin *ppinIn
);

Parameter

[in] ppinOut

Zeiger auf die IPin-Schnittstelle am Ausgabepin.

[in] ppinIn

Zeiger auf die IPin-Schnittstelle am Eingabenadel.

Rückgabewert

Gibt ein HRESULT zurück. Die folgenden Werte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
VFW_S_PARTIAL_RENDER
 Teilerfolg; einige Streams von diesem Pin verwenden ein nicht unterstütztes Format.
E_ABORT
 Der Vorgang wurde abgebrochen.
E_POINTER
 NULL-Zeigerargument.
VFW_E_CANNOT_CONNECT
 Es konnte keine Kombination von Zwischenfiltern gefunden werden, um die Verbindung herzustellen.
VFW_E_NOT_IN_GRAPH
 Mindestens einer der Filter befindet sich nicht im Filterdiagramm.

Hinweise

Diese Methode verbindet zwei Pins direkt oder indirekt und fügt bei Bedarf Zwischenfilter hinzu. Die Methode beginnt mit dem Versuch einer direkten Verbindung. Wenn dies fehlschlägt, wird versucht, alle Filter zu verwenden, die sich bereits im Filterdiagramm befinden und über nicht verbundene Eingabepins verfügen. (Sie listet diese in einer beliebigen Reihenfolge auf.) Wenn dies fehlschlägt, sucht es nach Filtern in der Registrierung und versucht sie in der Reihenfolge des Verdienstes. Weitere Informationen finden Sie unter Intelligent Connect.

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.

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