Método CBasePin.CompleteConnect

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O CompleteConnect método conclui uma conexão com outro pino.

Sintaxe

virtual HRESULT CompleteConnect(
   IPin *pReceivePin
);

Parâmetros

pReceivePin

Ponteiro para a interface IPin do outro pino.

Retornar valor

Returns S_OK.

Comentários

Esse método é chamado em ambos os pinos no final do processo de conexão. O pin de conexão o chama de dentro do método CBasePin::Connect e o pin de recebimento o chama de dentro do método CBasePin::ReceiveConnection .

Na classe base, esse método simplesmente retorna S_OK. Se uma classe derivada tiver requisitos para concluir uma conexão, ela deverá substituir esse método. Por exemplo, a classe CBaseOutputPin usa esse método para decidir o alocador de memória.

Se esse método falhar, a tentativa de conexão geral também falhará e o pino se desconectará do pino de recebimento.

Requisitos

Requisito Valor
parâmetro
Amfilter.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CBasePin