Método IRenderEngine::GetFilterGraph
[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 GetFilterGraph método recupera el gráfico de filtros que el motor de representación ha construido, si existe.
Sintaxis
HRESULT GetFilterGraph(
[out] IGraphBuilder **ppFG
);
Parámetros
-
ppFG [out]
-
Recibe un puntero a la interfaz IGraphBuilder del grafo de filtro. Recibe el valor NULL si no hay ningún grafo de filtro.
Valor devuelto
Devuelve uno de los siguientes valores HRESULT :
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
No se pudo inicializar el motor de representación. |
|
Puntero no válido. |
Observaciones
Use el método IRenderEngine::ConnectFrontEnd para compilar el front-end del gráfico de filtros. Para obtener una vista previa, use IRenderEngine::RenderOutputPins para completar el gráfico. Para la salida del archivo, conecte el front-end a una combinación de escritura de archivos o mux. Para obtener más información, vea Representación de un proyecto.
El gráfico resultante se puede ejecutar, pausar, detener y buscar; Sin embargo, no se puede cambiar la velocidad de reproducción.
Si el valor de *ppFG no es NULL, la interfaz IGraphBuilder tiene un recuento de referencias pendiente. Asegúrese de liberar la interfaz cuando haya terminado de usarla.
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