Método IGraphConfig::RemoveFilterEx (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 RemoveFilterEx método quita un filtro del gráfico de filtros.
Sintaxis
HRESULT RemoveFilterEx(
[in] IBaseFilter *pFilter,
[in] DWORD Flags
);
Parámetros
[in] pFilter
Puntero a la interfaz IBaseFilter del filtro que se va a quitar del gráfico.
[in] Flags
Combinación de marcas del tipo enumerado REM_FILTER_FLAGS .
Valor devuelto
Devuelve S_OK si se ejecuta correctamente o un valor HRESULT que indica la causa del error.
Observaciones
Este método extiende el método IFilterGraph::RemoveFilter aceptando una marca que especifica el comportamiento del método. Esta marca permite a una aplicación quitar un filtro sin desconectar automáticamente las patillas, lo que mejora el rendimiento al mover grupos de filtros conectados a un nuevo grafo.
De forma predeterminada, este método desconecta el filtro antes de quitarlo del gráfico. Use la marca REMFILTERF_LEAVECONNECTED para dejar el filtro conectado.
Requisitos
| 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 |