Método IRenderEngine::SetFilterGraph
[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 SetFilterGraph método especifica un gráfico de filtro para el motor de representación que se va a usar.
Sintaxis
HRESULT SetFilterGraph(
IGraphBuilder *pFG
);
Parámetros
-
Pfg
-
Puntero a la interfaz IGraphBuilder del gráfico de filtros.
Valor devuelto
Devuelve uno de los siguientes valores HRESULT :
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
Argumento no válido. |
|
No se pudo inicializar el motor de representación. |
Observaciones
La mayoría de las aplicaciones no necesitan llamar a este método. Es más habitual permitir que el motor de representación compile el gráfico de forma automática mediante una llamada al método IRenderEngine::ConnectFrontEnd .
Este método produce un error si el motor de representación ya tiene un gráfico de filtro.
Nunca recupere un puntero a un gráfico de filtros creado por un motor de representación y después úselo como parámetro para este método en otro motor de representación. Si lo hace, se producirán resultados imprevisibles.
El método ConnectFrontEnd desglosa cualquier gráfico de filtro existente, pero mantiene la misma instancia del Administrador de gráficos de filtros.
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