IFilterGraph::ConnectDirect-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 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