Metodo IPin::ReceiveConnection (strmif.h)

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il ReceiveConnection metodo accetta una connessione da un altro pin.

Le applicazioni non devono chiamare questo metodo. Questo metodo viene chiamato da altri filtri durante il processo di connessione pin.

Sintassi

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

Parametri

[in] pConnector

Puntatore all'interfaccia IPin del pin di connessione.

[in] pmt

Puntatore a una struttura AM_MEDIA_TYPE che specifica il tipo di supporto per la connessione.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Argomento puntatore NULL.
VFW_E_ALREADY_CONNECTED	Il pin è già connesso.
VFW_E_NOT_STOPPED	Impossibile connettersi mentre il filtro è attivo.
VFW_E_TYPE_NOT_ACCEPTED	Il tipo di supporto specificato non è accettabile.

Commenti

Quando un pin di output si connette, chiama questo metodo sul pin di input. Il pin di input deve verificare che il tipo di supporto specificato sia accettabile. Potrebbe anche essere necessario verificare la presenza di altri requisiti di connessione specifici del filtro proprietario. Se la connessione è adatta, il pin di input deve restituire S_OK ed eseguire anche le operazioni seguenti:

Archiviare il tipo di supporto e restituire lo stesso tipo nel metodo IPin::ConnectionMediaType .
Archiviare l'interfaccia IPin del pin di output (pConnector) e restituire questo puntatore nel metodo IPin::ConnectedTo .

Se la connessione non è adatta, il pin deve restituire un codice di errore.

La classe CBasePin implementa il framework di base per questo metodo, incluso l'archiviazione del tipo di supporto e dei puntatori IPin .

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici errore e esito positivo

Modalità di connessione dei filtri

Interfaccia IPin

Condividi tramite