Interfaz IGraphConfig (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.

Filter Graph Manager expone para admitir la creación de grafos dinámicos IGraphConfig . Esta interfaz permite a las aplicaciones y filtros volver a configurar el gráfico de filtros mientras el gráfico está en estado de ejecución y sin perder datos de la secuencia.

La manera más sencilla de volver a generar el grafo dinámicamente es llamar al método IGraphConfig::Reconnect . Este método controla la mayoría de los detalles de volver a generar dinámicamente el gráfico. Si alguna vez surge una situación en la que desea implementar su propia técnica, IGraphConfig también proporciona el método IGraphConfig::Reconfigure . Este método obtiene un bloqueo en el gráfico de filtros y, a continuación, llama a una función de devolución de llamada en la aplicación, que vuelve a configurar el gráfico. Con este método, la mayoría del trabajo se desplaza a la aplicación. Para obtener más información, vea Dynamic Graph Building.

Para optimizar el proceso de agregar y quitar filtros, el gráfico de filtros mantiene una caché de filtros. Durante una llamada al método Reconnect , puede especificar que los filtros quitados del grafo se agreguen a la memoria caché. También puede agregar un filtro a la memoria caché directamente, si sabe que es probable que sea necesario, llamando a IGraphConfig::AddFilterToCache. Los métodos IGraphBuilder::Render, IGraphBuilder::RenderFile e IGraphBuilder::Connect intentan usar automáticamente filtros en la memoria caché antes de usar otros filtros. Además, en el método Reconnect puede especificar que solo se usarán filtros almacenados en caché para la reconexión. Tenga en cuenta que los filtros contenidos en la memoria caché no forman parte del grafo. Se desconectan de cualquier patilla y se mantienen en un estado detenido.

Herencia

La interfaz IGraphConfig hereda de la interfaz IUnknown . IGraphConfig también tiene estos tipos de miembros:

Métodos

La interfaz IGraphConfig tiene estos métodos.

IGraphConfig::AddFilterToCache El método AddFilterToCache agrega un filtro a la caché de filtros.
IGraphConfig::EnumCacheFilter El método EnumCacheFilter enumera los filtros de la caché de filtros.
IGraphConfig::GetFilterFlags El método GetFilterFlags recupera la información de configuración de un filtro.
IGraphConfig::GetStartTime El método GetStartTime recupera la hora de referencia que se usó cuando el gráfico de filtro se puso por última vez en un estado en ejecución.
IGraphConfig::P ushThroughData El método PushThroughData inserta datos a través del gráfico de filtros en el pin especificado.
IGraphConfig::Reconfigure El método Reconfigure bloquea el gráfico de filtros y llama a una función de devolución de llamada en la aplicación o filtro para realizar una reconfiguración dinámica.
IGraphConfig::Reconnect El método Reconnect realiza una reconexión dinámica entre dos patillas.
IGraphConfig::RemoveFilterEx El método RemoveFilterEx quita un filtro del gráfico de filtros.
IGraphConfig::RemoveFilterFromCache El método RemoveFilterFromCache quita un filtro de la caché de filtros.
IGraphConfig::SetFilterFlags El método SetFilterFlags establece la información de configuración de un filtro.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)