Compartilhar via


Método CBasePin.BreakConnect

[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 BreakConnect método libera o pino de uma conexão.

Sintaxe

virtual HRESULT BreakConnect();

Parâmetros

Esse método não tem parâmetros.

Retornar valor

Returns S_OK.

Comentários

Esse método é chamado durante a desconexão de pin pelo método CBasePin::D isconnect . Ele também será chamado durante uma tentativa de conexão se o método CBasePin::CheckConnect falhar.

Esse método deve liberar todos os recursos obtidos pelo método CheckConnect . Por exemplo, se CheckConnect alocar memória, BreakConnect deverá liberar a memória. Se CheckConnect consultar o pino de conexão para uma interface, BreakConnect deverá liberar a interface .

Observe que BreakConnect pode ser chamado sem uma chamada correspondente para CompleteConnect. Portanto, você não pode assumir que CompleteConnect foi chamado anteriormente.

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