IPinConnection::IsEndPin-Methode (strmif.h)

[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 IsEndPin -Methode gibt an, ob eine Suche nach einer erneuten Verbindung an diesem Pin enden soll.

Syntax

HRESULT IsEndPin();

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
S_FALSE	Dieser Pin ist kein Kandidat für eine erneute Verbindung. (Die Suche nach der erneuten Verbindung sollte nicht an dieser Stecknadel enden.)
S_OK	Dieser Pin ist ein Kandidat für die erneute Verbindung. (Die Suche nach der erneuten Verbindung sollte an dieser Pin beendet werden.)

Hinweise

Ein Filter oder eine Anwendung kann diese Methode aufrufen, um zu bestimmen, ob der Pin ein Kandidat für die dynamische Wiederherstellung der Verbindung ist.

Im Allgemeinen sollte ein Senkenfilter oder ein Filter, der Daten aufteilt oder zusammenführt, S_OK zurückgeben. Andere Filter (z. B. einfache Transformationsfilter) sollten S_FALSE zurückgeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Dynamische Wiederherstellung der Verbindung

Fehler- und Erfolgscodes

IPinConnection-Schnittstelle