Cbasepin. receiveconnection-Methode

Die- ReceiveConnection Methode akzeptiert eine Verbindung von einer anderen Pin. Diese Methode implementiert die IPin:: receiveconnection -Methode.

Syntax

HRESULT ReceiveConnection(
   IPin          *pConnector,
   AM_MEDIA_TYPE *pmt
);

Parameter

pconnector

Ein Zeiger auf die IPin -Schnittstelle der Verbindungs-PIN.

PMT

Zeiger auf eine am _ - _ Medientyp Struktur, die den Medientyp angibt.

Rückgabewert

Gibt einen HRESULT -Wert zurück. Mögliche Werte sind die in der folgenden Tabelle aufgeführten Werte.

Rückgabecode Beschreibung
S _ OK
Erfolg.
E- _ Zeiger
Null -Zeigerargument.
VFW _ E _ bereits _ verbunden
Die PIN ist bereits verbunden.
VFW _ E _ nicht _ angehalten
Der Filter ist aktiv, und die PIN unterstützt keine dynamische erneute Verbindung.
VFW _ E- _ Typ _ nicht _ akzeptiert
Der angegebene Medientyp ist nicht zulässig.

Bemerkungen

Die Ausgabe-PIN ruft diese Methode für die Eingabe-PIN auf. Wenn die Eingabe-PIN einen Fehlercode zurückgibt, schlägt die Verbindung fehl.

In der-Basisklasse führt diese Methode die folgenden Schritte aus:

  • Überprüft, ob die PIN bereits verbunden ist.
  • Überprüft, ob der Filter beendet wurde.
  • Ruft die cbasepin:: checkConnect -Methode auf, um zu überprüfen, ob die Verbindungs-Pin geeignet ist.
  • Ruft die cbasepin:: checkmediatype -Methode auf, um zu testen, ob der Medientyp zulässig ist.

Wenn alle diese Schritte erfolgreich ausgeführt wurden, ruft die-Methode die cbasepin:: completeconnect -Methode und die setmediatype -Methode auf, um die Verbindung abzuschließen. Diese Methoden speichern den Medientyp und einen Zeiger auf die Ausgabe-PIN.

Wenn checkConnect oder checkmediatype fehlschlägt, ruft die Basisklasse die cbasepin:: breakconnect -Methode auf, um die Verbindung zu unterbrechen, und gibt dann einen Fehlercode aus zurück ReceiveConnection .

Anforderungen

Anforderung Wert
Header
Amfilter. h (Include Streams. h)
Bibliothek
"
Straumbase. lib" (Einzelhandels Builds);
"
Straumbasd. lib" (Debugbuilds)

Siehe auch

Cbasepin-Klasse