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

Essa interface fornece métodos que permitem que um aplicativo crie um grafo de filtro. O Gerenciador de Grafo de Filtro implementa essa interface.

A interface IGraphBuilder herda da interface IFilterGraph . O IFilterGraph fornece operações básicas, como adicionar um filtro ao grafo ou conectar dois pinos. IGraphBuilder adiciona outros métodos que constroem grafos a partir de informações parciais. Por exemplo, o método IGraphBuilder::RenderFile cria um grafo para reprodução de arquivo, dado o nome do arquivo. O método IGraphBuilder::Render renderiza dados de um pino de saída conectando novos filtros ao pino.

Usando esses métodos, um aplicativo não precisa especificar cada conexão de filtro e fixação no grafo. Em vez disso, o Gerenciador de Grafo de Filtro seleciona filtros registrados no sistema do usuário, adiciona-os ao grafo e os conecta. Para obter mais informações, confira Conexão Inteligente.

Herança

A interface IGraphBuilder herda do IFilterGraph. O IGraphBuilder também tem esses tipos de membros:

Métodos

A interface IGraphBuilder tem esses métodos.

IGraphBuilder::Abort O método Abort solicita que o Gerenciador de Grafo de Filtro interrompa sua tarefa atual o mais rápido possível.
IGraphBuilder::AddSourceFilter O método AddSourceFilter adiciona um filtro de origem para um arquivo especificado ao grafo de filtro.
IGraphBuilder::Connect O método Connect conecta os dois pinos, usando intermediários, se necessário.
IGraphBuilder::Render O método Render cria um grafo de filtro que renderiza os dados de um pino de saída especificado.
IGraphBuilder::RenderFile O método RenderFile cria um grafo de filtro que renderiza o arquivo especificado. (IGraphBuilder.RenderFile)
IGraphBuilder::SetLogFile O método SetLogFile define o arquivo para ações de registro em log executadas ao tentar executar uma operação.
IGraphBuilder::ShouldOperationContinue O método ShouldOperationContinue consulta se a operação atual deve continuar.

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)

Confira também

Ifiltergraph

Interfaces