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.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Falha. |
|
Argumento de ponteiro NULL. |
|
O pin não está conectado. |
|
O filtro não foi interrompido. |
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
| 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 |