Metodo CBasePin.AttemptConnection
[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 |
---|---|
|
Operazione completata. |
|
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 |
|
Libreria |
|