Metodo IFilterChain::RemoveChain (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 RemoveChain metodo rimuove ogni filtro in una catena di filtri dal grafico del filtro.

Sintassi

HRESULT RemoveChain(
  [in] IBaseFilter *pStartFilter,
  [in] IBaseFilter *pEndFilter
);

Parametri

[in] pStartFilter

Puntatore all'interfaccia IBaseFilter del filtro all'inizio della catena.

[in] pEndFilter

Puntatore all'interfaccia IBaseFilter del filtro alla fine della catena. Se questo parametro è NULL, il metodo usa la catena di filtri più lunga possibile che estende downstream dal filtro iniziale.

Valore restituito

Restituisce S_OK se ha esito positivo o un valore HRESULT che indica la causa dell'errore in caso contrario.

Commenti

È possibile chiamare questo metodo mentre il grafico è in esecuzione; il metodo arresta i filtri nella catena prima di rimuoverli dal grafico.

Requisiti

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

Vedi anche

Codici errore e esito positivo

Interfaccia IFilterChain