IPin-Schnittstelle (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.]
Diese Schnittstelle wird von allen Eingabe- und Ausgabepins verfügbar gemacht.
Der Filterdiagramm-Manager verwendet diese Schnittstelle, um Pins zu verbinden und Leerungsvorgänge auszuführen. Anwendungen können diese Schnittstelle verwenden, um die Pin nach Informationen abzufragen. Anwendungen sollten niemals Methoden aufrufen IPin , die den Status einer Pin ändern, z. B. Verbinden, Trennen, BeginFlush oder EndFlush. Um Pins zu verbinden, muss eine Anwendung die Methoden in IGraphBuilder verwenden.
Filterentwickler: Die Klassen CBasePin, CBaseInputPin und CBaseOutputPin implementieren diese Schnittstelle. Andere Basisklassen werden von diesen drei Klassen abgeleitet.
Vererbung
Die IPin-Schnittstelle erbt von der IUnknown-Schnittstelle . IPin verfügt auch über folgende Arten von Membern:
Methoden
Die IPin-Schnittstelle verfügt über diese Methoden.
| IPin::BeginFlush Die BeginFlush-Methode beginnt mit einem Leerungsvorgang. (IPin.BeginFlush) |
| IPin::Connect Die Connect-Methode verbindet den Pin mit einem anderen Pin. |
| IPin::ConnectedTo Die ConnectedTo-Methode ruft einen Zeiger auf den verbundenen Pin ab, falls vorhanden. |
| IPin::ConnectionMediaType Die ConnectionMediaType-Methode ruft ggf. den Medientyp für die aktuelle Pinverbindung ab. |
| IPin::D isconnect Die Disconnect-Methode unterbricht die aktuelle Pinverbindung. |
| IPin::EndFlush Die EndFlush-Methode beendet einen Leerungsvorgang. (IPin.EndFlush) |
| IPin::EndOfStream Die EndOfStream-Methode benachrichtigt den Pin, dass keine zusätzlichen Daten erwartet werden, bis ein neuer Ausführungsbefehl für den Filter ausgegeben wird. |
| IPin::EnumMediaTypes Die EnumMediaTypes-Methode listet die bevorzugten Medientypen der Pin auf. |
| IPin::NewSegment Die NewSegment-Methode benachrichtigt den Pin, dass Medienbeispiele, die nach diesem Aufruf empfangen werden, als Segment mit einer gemeinsamen Startzeit, Stoppzeit und Rate gruppiert sind. |
| IPin::QueryAccept Die QueryAccept-Methode bestimmt, ob die Pin einen angegebenen Medientyp akzeptiert. |
| IPin::QueryDirection Die QueryDirection-Methode ruft die Richtung des Pins (Eingabe oder Ausgabe) ab. |
| IPin::QueryId Die QueryId-Methode ruft einen Bezeichner für den Pin ab. |
| IPin::QueryInternalConnections Die QueryInternalConnections-Methode ruft die Pins ab, die intern mit diesem Pin (innerhalb des Filters) verbunden sind. |
| IPin::QueryPinInfo Die QueryPinInfo-Methode ruft Informationen über die Pin ab. |
| IPin::ReceiveConnection Die ReceiveConnection-Methode akzeptiert eine Verbindung von einem anderen Pin. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |