CBasePin.CheckConnect-Methode

Die CheckConnect -Methode bestimmt, ob eine Stecknadelverbindung geeignet ist.

Syntax

virtual HRESULT CheckConnect(
   IPin *pPin
);

Parameter

pPin

Zeiger auf die IPin-Schnittstelle des anderen Pins.

Rückgabewert

Gibt einen der in der folgenden Tabelle gezeigten HRESULT-Werte zurück.

Rückgabecode Beschreibung
S _ OK
Erfolg.
VFW _ E _ UNGÜLTIGE _ RICHTUNG
Pin-Anweisungen sind nicht kompatibel.

Hinweise

Diese Methode wird bei beiden Pins zu Beginn des Verbindungsprozesses aufgerufen. Der Verbindungspin ruft ihn innerhalb der CBasePin::Verbinden-Methode auf, und der empfangende Pin ruft ihn innerhalb der CBasePin::ReceiveConnection-Methode auf.

Verwenden Sie diese Methode, um zu bestimmen, ob der vom pPin-Parameter angegebene Pin für eine Verbindung geeignet ist. Die Basisklasse gibt einen Fehler zurück, wenn beide Pins die gleiche Richtung haben (beide Eingaben oder beide Ausgaben). Abgeleitete Klassen können diese Methode überschreiben, um andere Features im Pin zu überprüfen. Beispielsweise fragt die CBaseOutputPin-Klasse den Eingabepin für die IMemInputPin-Schnittstelle ab.

Wenn bei dieser Methode ein Fehler auftritt, schlägt die Verbindung fehl, und die PIN ruft die CBasePin::BreakConnect-Methode auf. Verwenden Sie BreakConnect, um alle in erhaltenen Ressourcen frei zu CheckConnect geben. Wenn z. CheckConnect B. die QueryInterface-Methode aufruft, muss BreakConnect die -Schnittstelle frei geben.

Anforderungen

Anforderung Wert
Header
Amfilter.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandels-Builds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBasePin-Klasse