IGraphBuilder::Connect-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 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 |
|---|---|
|
Erfolg. |
|
Teilerfolg; einige Streams von diesem Pin verwenden ein nicht unterstütztes Format. |
|
Der Vorgang wurde abgebrochen. |
|
NULL-Zeigerargument. |
|
Es konnte keine Kombination von Zwischenfiltern gefunden werden, um die Verbindung herzustellen. |
|
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 |