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.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
O pino não estava conectado. Nenhum erro. |
|
Falha. |
|
Argumento de ponteiro NULL. |
|
O filtro não é interrompido, mas não dá suporte à reconexão durante um estado em execução. |
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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |