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 |
|---|---|
|
Erfolg. |
|
Null -Zeigerargument. |
|
Die PIN ist bereits verbunden. |
|
Der Filter ist aktiv, und die PIN unterstützt keine dynamische erneute Verbindung. |
|
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 |
|
| Bibliothek |
|