Freigeben über


IPin::ReceiveConnection-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die ReceiveConnection -Methode akzeptiert eine Verbindung von einem anderen Pin.

Anwendungen sollten diese Methode nicht aufrufen. Diese Methode wird während des Pinverbindungsprozesses von anderen Filtern aufgerufen.

Syntax

HRESULT ReceiveConnection(
  [in] IPin                *pConnector,
  [in] const AM_MEDIA_TYPE *pmt
);

Parameter

[in] pConnector

Zeiger auf die IPin-Schnittstelle des Verbindungspins.

[in] pmt

Zeiger auf eine AM_MEDIA_TYPE-Struktur , die den Medientyp für die Verbindung angibt.

Rückgabewert

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

Rückgabecode Beschreibung
S_OK
Erfolg.
E_POINTER
NULL-Zeigerargument.
VFW_E_ALREADY_CONNECTED
Der Pin ist bereits verbunden.
VFW_E_NOT_STOPPED
Die Verbindung kann nicht hergestellt werden, während der Filter aktiv ist.
VFW_E_TYPE_NOT_ACCEPTED
Der angegebene Medientyp ist nicht akzeptabel.

Bemerkungen

Wenn eine Ausgabenadel eine Verbindung herstellt, wird diese Methode am Eingabenadel aufgerufen. Der Eingabenadel sollte überprüfen, ob der angegebene Medientyp akzeptabel ist. Möglicherweise muss auch nach anderen Verbindungsanforderungen gesucht werden, die für den Besitzerfilter spezifisch sind. Wenn die Verbindung geeignet ist, sollte der Eingabenadel S_OK zurückgeben und außerdem die folgenden Aktionen ausführen:

Wenn die Verbindung nicht geeignet ist, sollte der Pin einen Fehlercode zurückgeben.

Die CBasePin-Klasse implementiert das grundlegende Framework für diese Methode, einschließlich des Speicherns des Medientyps und der IPin-Zeiger .

Anforderungen

   
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)
Bibliothek Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

Herstellen einer Verbindung mit Filtern

IPin-Schnittstelle