Método IGraphConfig::RemoveFilterEx (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O RemoveFilterEx método remove um filtro do grafo de filtro.

Sintaxe

HRESULT RemoveFilterEx(
  [in] IBaseFilter *pFilter,
  [in] DWORD       Flags
);

Parâmetros

[in] pFilter

Ponteiro para a interface IBaseFilter do filtro a ser removido do grafo.

[in] Flags

Combinação de sinalizadores do tipo enumerado REM_FILTER_FLAGS .

Retornar valor

Retorna S_OK se tiver êxito ou um valor HRESULT que indica a causa da falha.

Comentários

Esse método estende o método IFilterGraph::RemoveFilter aceitando um sinalizador que especifica o comportamento do método. Esse sinalizador permite que um aplicativo remova um filtro sem desconectar os pinos automaticamente, o que melhora o desempenho ao mover grupos de filtros conectados para um novo grafo.

Por padrão, esse método desconecta o filtro antes de removê-lo do grafo. Use o sinalizador REMFILTERF_LEAVECONNECTED para deixar o filtro conectado.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IGraphConfig Interface