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:

• Speichern Sie den Medientyp, und geben Sie denselben Typ in der IPin::ConnectionMediaType-Methode zurück.
• Speichern Sie die IPin-Schnittstelle des Ausgabepins (pConnector), und geben Sie diesen Zeiger in der IPin::ConnectedTo-Methode zurück.

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