CBasePin.AttemptConnection-Methode
[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 |
|---|---|
|
Erfolg. |
|
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 |
|
| Bibliothek |
|