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

Consulte también

Códigos de error y éxito

IGraphConfig (interfaz)