IFilterGraph::ConnectDirect-Methode (strmif.h)

Artikel
07/28/2023

[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 ConnectDirect -Methode verbindet die beiden Pins direkt (ohne dazwischen liegende Filter).

Syntax

HRESULT ConnectDirect(
  [in] IPin                *ppinOut,
  [in] IPin                *ppinIn,
  [in] const AM_MEDIA_TYPE *pmt
);

Parameter

[in] ppinOut

Zeiger auf den Ausgabenadel.

[in] ppinIn

Zeiger auf den Eingabenadel.

[in] pmt

Zeiger auf den Medientyp, der für die Verbindung verwendet werden soll (optional; kann NULL sein).

Rückgabewert

Gibt einen der folgenden Werte oder einen von IPin::Connect zurückgegebenen Fehlerwert zurück.

Rückgabecode	Beschreibung
S_OK	Erfolg.
E_POINTER	NULL-Zeigerargument.
VFW_E_NOT_IN_GRAPH	Einer der angegebenen Pins befindet sich nicht im Diagramm.
VFW_E_CIRCULAR_GRAPH	Der Eingabestift ist Upstream des Ausgabepins, was zu einem kreisförmigen Diagramm führen würde.

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

Fehler- und Erfolgscodes

IFilterGraph-Schnittstelle

Freigeben über