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 |
|---|---|
|
Dieser Pin ist kein Kandidat für eine erneute Verbindung. (Die Suche nach der erneuten Verbindung sollte nicht an dieser Stecknadel enden.) |
|
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 |