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 |
---|---|
|
Êxito. |
|
Falha. |
|
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 |