CBasePin.AttemptConnection-Methode

  • 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 AttemptConnection -Methode stellt mithilfe eines angegebenen Medientyps eine Verbindung mit einer anderen Pin her.

Syntax

virtual HRESULT AttemptConnection(
         IPin       *pReceivePin,
   const CMediaType *pmt
);

Parameter

pReceivePin

Zeiger auf die IPin-Schnittstelle des empfangenden Pins.

Pmt

Zeiger auf ein CMediaType-Objekt , das den Medientyp angibt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die werte in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
VFW_E_TYPE_NOT_ACCEPTED
 Der Medientyp ist nicht akzeptabel.

Bemerkungen

Diese Methode versucht, die beiden Pins mit einem bestimmten Medientyp zu verbinden. Wenn der Typ nicht akzeptabel ist, schlägt die Methode fehl, ohne andere Medientypen auszuprobieren.

Wenn der Medientyp akzeptabel ist, ruft diese Methode die IPin::ReceiveConnection-Methode des empfangenden Pins auf. Anschließend wird die CBasePin::CompleteConnect-Methode aufgerufen, um die Verbindung abzuschließen.

Anforderungen

Anforderung Wert
Header
Amfilter.h (streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBasePin-Klasse