Interface IFilterChain (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.]

A IFilterChain interface fornece métodos para iniciar, parar ou remover cadeias de filtros em um grafo de filtro. O gerenciador de grafo de filtro expõe essa interface.

Uma cadeia de filtros é uma sequência de filtros, cada um com no máximo um pino de entrada conectado e um pino de saída conectado, que forma uma linha ininterrupta de filtros. Uma cadeia de filtros é definida pelo filtro no início da cadeia e pelo filtro no final da cadeia. (Eles podem ser o mesmo filtro, fazendo uma cadeia de um filtro.) Por definição, há um único caminho de fluxo que vai do início da cadeia downstream até o final da cadeia.

Os métodos nessa interface são úteis em situações em que um fluxo inteiro de dados pode aparecer ou desaparecer, como um aplicativo de videoconferência que recebe vários fluxos por uma rede. Para obter mais informações, consulte Dynamic Graph Building. Para controlar fluxos individuais em um filtro de captura, use a interface IAMStreamControl .

Herança

A interface IFilterChain herda da interface IUnknown . IFilterChain também tem estes tipos de membros:

Métodos

A interface IFilterChain tem esses métodos.

IFilterChain::P auseChain O método PauseChain alterna todos os filtros em uma cadeia de filtros para um estado pausado.
IFilterChain::RemoveChain O método RemoveChain remove todos os filtros em uma cadeia de filtros do grafo de filtro.
IFilterChain::StartChain O método StartChain alterna todos os filtros em uma cadeia de filtros para um estado em execução.
IFilterChain::StopChain O método StopChain alterna todos os filtros em uma cadeia de filtros para um estado parado.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	strmif.h (inclua Dshow.h)