Metodo CBasePin.AttemptConnection

  • Articolo

[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 AttemptConnection metodo si connette a un altro pin usando un tipo di supporto specificato.

Sintassi

virtual HRESULT AttemptConnection(
         IPin       *pReceivePin,
   const CMediaType *pmt
);

Parametri

pReceivePin

Puntatore all'interfaccia IPin del pin di ricezione.

Pmt

Puntatore a un oggetto CMediaType che specifica il tipo di supporto.

Valore restituito

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

Codice restituito Descrizione
S_OK
 Operazione completata.
VFW_E_TYPE_NOT_ACCEPTED
 Il tipo di supporto non è accettabile.

Commenti

Questo metodo tenta di connettere i due pin con un tipo di supporto specifico. Se il tipo non è accettabile, il metodo ha esito negativo senza provare altri tipi di supporti.

Se il tipo di supporto è accettabile, questo metodo chiama il metodo IPin::ReceiveConnection del pin ricevente . Chiama quindi il metodo CBasePin::CompleteConnect per completare la connessione.

Requisiti

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

Vedi anche

Classe CBasePin