Metodo CBasePin.CompleteConnect

  • Articolo

[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
Amfilter.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBasePin