IRenderEngine::ConnectFrontEnd (método)

[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.

Nota:

[Desusado. Esta API se puede quitar de futuras versiones de Windows.]

 

El ConnectFrontEnd método compila el front-end del gráfico de filtros a partir de la escala de tiempo actual.

Sintaxis

HRESULT ConnectFrontEnd();

Parámetros

Este método no tiene parámetros.

Valor devuelto

Devuelve un valor HRESULT . Entre los valores devueltos posibles se incluyen los siguientes:

Código devuelto	Descripción
S_OK	Correcto.
S_WARN_OUTPUTRESET	Se eliminó la parte de representación del grafo.
E_INVALIDARG	No hay ninguna escala de tiempo establecida para este motor de representación.
E_MUST_INIT_RENDERER	No se pudo inicializar el motor de representación.
E_RENDER_ENGINE_IS_BROKEN	Error en la operación porque el proyecto no se ha representado correctamente.
E_UNEXPECTED	error inesperado.
VFW_E_INVALIDMEDIATYPE	Tipo de medio no válido.

 

Observaciones

Este método no crea la parte de representación del grafo de filtro. La aplicación debe conectar los pines de salida en el front-end a los filtros de representación deseados:

• Para obtener una vista previa, llame al método IRenderEngine::RenderOutputPins .
• Para generar un archivo, llame a IRenderEngine::GetGroupOutputPin para recuperar el pin de salida de cada grupo y, a continuación, conecte los pines a un filtro de multiplexador.

Si usa el motor de representación básico, las patillas de salida del front-end generan datos sin comprimir. Si usa el motor de representación inteligente, las patillas de salida generan datos comprimidos.

Si cambia la escala de tiempo después de compilar el gráfico de filtros, debe llamar ConnectFrontEnd de nuevo para volver a generar el front-end. El método conserva la parte de representación del gráfico siempre que sea posible. Sin embargo, si agrega o elimina un grupo, o cambia el orden de los grupos, ConnectFrontEnd elimina la parte de representación y la aplicación debe recompilarla. Si el método elimina la parte de representación, devuelve S_WARN_OUTPUTRESET.

Nota:

El archivo de encabezado Qedit.h no es compatible con los encabezados de Direct3D posteriores a la versión 7.

 

Nota:

Para obtener Qedit.h, descargue la actualización de Microsoft Windows SDK para Windows Vista y .NET Framework 3.0. Qedit.h no está disponible en el Microsoft Windows SDK para Windows 7 y .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito	Value
Encabezado	Qedit.h
Biblioteca	Strmiids.lib

Consulte también

IRenderEngine (interfaz)

Códigos de error y éxito