Metodo CBasePin.CompleteConnect
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il CompleteConnect
metodo completa una connessione a un altro pin.
Sintassi
virtual HRESULT CompleteConnect(
IPin *pReceivePin
);
Parametri
-
pReceivePin
-
Puntatore all'interfaccia IPin dell'altro pin.
Valore restituito
Restituisce S_OK.
Commenti
Questo metodo viene chiamato su entrambi i pin alla fine del processo di connessione. Il pin di connessione lo chiama dall'interno del metodo CBasePin::Connect e il pin ricevente lo chiama dall'interno del metodo CBasePin::ReceiveConnection .
Nella classe base questo metodo restituisce semplicemente S_OK. Se una classe derivata ha requisiti per completare una connessione, deve eseguire l'override di questo metodo. Ad esempio, la classe CBaseOutputPin usa questo metodo per decidere l'allocatore di memoria.
Se questo metodo ha esito negativo, anche il tentativo di connessione complessivo ha esito negativo e il pin si disconnette dal pin ricevente.
Requisiti
Requisito | Valore |
---|---|
Intestazione |
|
Libreria |
|