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)