Metodo IFilterGraph::RemoveFilter (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il RemoveFilter metodo rimuove un filtro dal grafico.

Sintassi

HRESULT RemoveFilter(
  [in] IBaseFilter *pFilter
);

Parametri

[in] pFilter

Puntatore al filtro da rimuovere dal grafico.

Valore restituito

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Esito negativo.
E_POINTER	Argomento puntatore NULL.

Commenti

Filter Graph Manager notifica al filtro che viene rimosso chiamando il metodo IBaseFilter::JoinFilterGraph con un argomento NULL . Non è necessario disconnettere i pin del filtro prima di chiamare RemoveFilter, ma il grafico del filtro deve trovarsi nello stato arrestato. Se i filtri non vengono arrestati, RemoveFilter potrebbe non riuscire a disconnettere i pin e quindi non è possibile rimuovere il filtro dal grafico. IGraphConfig::RemoveFilterEx consente a un'applicazione di rimuovere un filtro senza disconnettere automaticamente i pin, migliorando le prestazioni se si desidera spostare gruppi di filtri connessi in un nuovo grafico.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IFilterGraph