Método IFilterGraph::Reconnect (strmif.h)

[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 Reconnect método desconecta um pino e reconecta-o ao mesmo pino.

Os aplicativos não devem chamar esse método. Ele é chamado por filtros durante o processo de criação do grafo.

Sintaxe

HRESULT Reconnect(
  [in] IPin *ppin
);

Parâmetros

[in] ppin

Ponteiro para a interface IPin do pino a ser reconectado.

Retornar valor

Retorna um dos valores a seguir.

Comentários

Esse método está obsoleto; em vez disso, use o método IFilterGraph2::ReconnectEx .

Os filtros podem chamar esse método para renegociar uma conexão de pino. O método é executado em um thread separado. Antes de chamar esse método, chame IPin::QueryAccept no outro pin para garantir que a tentativa de reconexão seja bem-sucedida. Não chame esse método, a menos que QueryAccept retorne S_OK. Caso contrário, como a reconexão é executada de forma assíncrona, a reconexão pode falhar mesmo que o Reconnect método seja bem-sucedido, deixando o grafo de filtro em um estado inconsistente.

Requisitos

Confira também

Códigos de erro e êxito

IFilterGraph Interface

Reconectando pinos