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) |