CTransformInputPin.CheckConnect-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 CheckConnect -Methode bestimmt, ob eine Pinverbindung geeignet ist.

Syntax

HRESULT CheckConnect(
   IPin *pPin
);

Parameter

pPin

Zeiger auf die IPin-Schnittstelle des Ausgabepins.

Rückgabewert

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

Rückgabecode Beschreibung
S_OK
Erfolgreich
VFW_E_INVALID_DIRECTION
Falsche Stiftrichtung

Bemerkungen

Diese Methode überschreibt die CBasePin::CheckConnect-Methode . Sie ruft die CTransformFilter::CheckConnect-Methode des Filters auf, die S_OK in der Basisklasse zurückgibt. Die abgeleitete Klasse kann die CTransformFilter::CheckConnect-Methode überschreiben, um zusätzliche Überprüfungen durchzuführen.

Anforderungen

Anforderung Wert
Header
Transfrm.h (Einschließen von Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)