Metodo CBasePin.Connect

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 Connect metodo connette il pin a un altro pin. Questo metodo implementa il metodo IPin::Connect .

Sintassi

HRESULT Connect(
         IPin          *pReceivePin,
   const AM_MEDIA_TYPE *pmt
);

Parametri

pReceivePin: Puntatore all'interfaccia IPin del pin di ricezione.
Pmt: Puntatore a una struttura AM_MEDIA_TYPE che specifica il tipo di supporto per la connessione.

Valore restituito

Restituisce un valore HRESULT . I valori possibili includono quelli nella tabella seguente.

Codice restituito	Descrizione
S_OK	Operazione completata.
VFW_E_ALREADY_CONNECTED	Il pin è già connesso.
VFW_E_NO_ACCEPTABLE_TYPES	Impossibile trovare un tipo di supporto accettabile.
VFW_E_NOT_STOPPED	Il filtro è attivo e il pin non supporta la riconnessione dinamica.
VFW_E_TYPE_NOT_ACCEPTED	Il tipo di supporto specificato non è accettabile.

Commenti

Il parametro pmt può essere NULL. Può anche specificare un tipo di supporto parziale, con un valore di GUID_NULL per il tipo principale, il sottotipo o il formato.

Nella classe di base questo metodo verifica se il pin è già connesso e se il filtro viene arrestato. Delega il resto del processo di connessione al metodo CBasePin::AgreeMediaType .

Requisiti

Requisito	Valore
Intestazione	Amfilter.h (include Streams.h)
Libreria	Strmbase.lib (build al dettaglio); Strmbasd.lib (build di debug)

Vedi anche

Classe CBasePin

Condividi tramite