Método IFilterGraph2::ReconnectEx (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 ReconnectEx método quebra a conexão de pino existente e reconecta-a ao mesmo pino, usando um tipo de mídia especificado.

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

Sintaxe

HRESULT ReconnectEx(
  [in] IPin                *ppin,
  [in] const AM_MEDIA_TYPE *pmt
);

Parâmetros

[in] ppin

Ponteiro para o pino para desconectar e reconectar.

[in] pmt

Ponteiro para o tipo de mídia com o qual se reconectar. Especifique NULL para usar o tipo de mídia existente.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Comentários

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 ReconnectEx método tenha êxito, deixando o grafo de filtro em um estado inconsistente.

Esse método melhora o método IFilterGraph::Reconnect especificando um tipo de mídia. Isso torna a reconexão mais provável de ter êxito.

Requisitos

Confira também

Códigos de erro e êxito

IFilterGraph2 Interface

Reconectando pinos