Interfaz IGraphBuilder (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
Esta interfaz proporciona métodos que permiten a una aplicación compilar un gráfico de filtros. Filter Graph Manager implementa esta interfaz.
La interfaz IGraphBuilder hereda de la interfaz IFilterGraph . IFilterGraph proporciona operaciones básicas, como agregar un filtro al grafo o conectar dos patillas. IGraphBuilder agrega métodos adicionales que construyen gráficos a partir de información parcial. Por ejemplo, el método IGraphBuilder::RenderFile crea un gráfico para la reproducción de archivos, según el nombre del archivo. El método IGraphBuilder::Render representa los datos de un pin de salida mediante la conexión de nuevos filtros al pin.
Con estos métodos, una aplicación no necesita especificar cada conexión de filtro y anclaje en el gráfico. En su lugar, el Administrador de gráficos de filtros selecciona los filtros registrados en el sistema del usuario, los agrega al gráfico y los conecta. Para obtener más información, consulte Intelligent Connect.
Herencia
La interfaz IGraphBuilder hereda de IFilterGraph. IGraphBuilder también tiene estos tipos de miembros:
Métodos
La interfaz IGraphBuilder tiene estos métodos.
| IGraphBuilder::Abort El método Abort solicita al Administrador de gráficos de filtros que detenga su tarea actual lo antes posible. |
| IGraphBuilder::AddSourceFilter El método AddSourceFilter agrega un filtro de origen para un archivo especificado al gráfico de filtros. |
| IGraphBuilder::Connect El método Connect conecta los dos pines, mediante intermedios si es necesario. |
| IGraphBuilder::Render El método Render crea un gráfico de filtro que representa los datos de un pin de salida especificado. |
| IGraphBuilder::RenderFile El método RenderFile crea un gráfico de filtro que representa el archivo especificado. (IGraphBuilder.RenderFile) |
| IGraphBuilder::SetLogFile El método SetLogFile establece el archivo para las acciones de registro realizadas al intentar realizar una operación. |
| IGraphBuilder::ShouldOperationContinue El método ShouldOperationContinue consulta si la operación actual debe continuar. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluye Dshow.h) |