CBasePin.CompleteConnect-Methode
[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 CompleteConnect -Methode schließt eine Verbindung mit einem anderen Pin ab.
Syntax
virtual HRESULT CompleteConnect(
IPin *pReceivePin
);
Parameter
-
pReceivePin
-
Zeiger auf die IPin-Schnittstelle des anderen Pins.
Rückgabewert
Gibt S_OK zurück.
Bemerkungen
Diese Methode wird am Ende des Verbindungsvorgangs für beide Pins aufgerufen. Der Verbindungspin ruft sie aus der CBasePin::Connect-Methode auf, und der empfangende Pin ruft sie aus der CBasePin::ReceiveConnection-Methode auf.
In der Basisklasse gibt diese Methode einfach S_OK zurück. Wenn eine abgeleitete Klasse Anforderungen für den Abschluss einer Verbindung hat, sollte sie diese Methode außer Kraft setzen. Beispielsweise verwendet die CBaseOutputPin-Klasse diese Methode, um den Speicherzuteilungsvorgang zu bestimmen.
Wenn diese Methode fehlschlägt, schlägt auch der gesamte Verbindungsversuch fehl, und der Pin wird vom empfangenden Pin getrennt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|