Método IGraphConfigCallback::Reconfigure (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.

El Reconfigure método es un método de devolución de llamada pasado a IGraphConfig::Reconfigure.

Sintaxis

HRESULT Reconfigure(
  PVOID pvContext,
  DWORD dwFlags
);

Parámetros

pvContext

Valor pasado en el parámetro pvContext del método IGraphConfig::Reconfigure.

dwFlags

Valor pasado en el parámetro dwFlags del método IGraphConfig::Reconfigure.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor HRESULT que indica la causa del error.

Comentarios

Si la aplicación o el filtro llama a IGraphConfig::Reconfigure, debe implementar este método y pasarlo como devolución de llamada. El método IGraphConfig::Reconfigure obtiene un bloqueo en el gráfico de filtros antes de llamar al Reconfigure método . A continuación, el método controla todos los demás detalles de la creación dinámica de grafos.

Si este método se ejecuta correctamente, IGraphConfig::Reconfigure intenta volver a colocar todos los filtros del grafo en un estado en ejecución. Si se produce un error en el método, IGraphConfig::Reconfigure devuelve el código de error que devolvió este método.

Este método permite recompilar grafos especializados. Para obtener un enfoque más sencillo para la creación de grafos dinámicos, consulte IGraphConfig::Reconnect.

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)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IGraphConfigCallback (interfaz)