Compartilhar via


Método IFilterGraph::RemoveFilter (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 RemoveFilter método remove um filtro do grafo.

Sintaxe

HRESULT RemoveFilter(
  [in] IBaseFilter *pFilter
);

Parâmetros

[in] pFilter

Ponteiro para o filtro a ser removido do grafo.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
Êxito.
E_FAIL
Falha.
E_POINTER
Argumento de ponteiro NULL.

Comentários

O Gerenciador de Grafo de Filtro notifica o filtro de que ele está sendo removido chamando o método IBaseFilter::JoinFilterGraph do filtro com um argumento NULL . Não é necessário desconectar os pinos do filtro antes de chamar RemoveFilter, mas o grafo de filtro deve estar no estado Parado. Se os filtros não forem interrompidos, RemoveFilter poderá falhar ao desconectar os pinos e, em seguida, falhar ao remover o filtro do grafo. IGraphConfig::RemoveFilterEx permite que um aplicativo remova um filtro sem desconectar os pinos automaticamente, o que melhora o desempenho se você quiser mover grupos de filtros conectados para um novo grafo.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [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

IFilterGraph Interface