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 |
|---|---|
|
Correcto. |
|
Se eliminó la parte de representación del grafo. |
|
No hay ninguna escala de tiempo establecida para este motor de representación. |
|
No se pudo inicializar el motor de representación. |
|
Error en la operación porque el proyecto no se ha representado correctamente. |
|
error inesperado. |
|
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 |
|
| Biblioteca |
|
Consulte también