Metodo IFilterChain::P auseChain (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 PauseChain metodo commuta tutti i filtri in una catena di filtri in uno stato sospeso.

Sintassi

HRESULT PauseChain(
  [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 riuscito. Se il metodo ha esito negativo, il valore restituito può essere VFW_E_NOT_PAUSED o un altro valore HRESULT .

Commenti

Se questo metodo non può cambiare un determinato filtro in uno stato sospeso, arresta tutti i filtri nella catena. Il grafico del filtro deve essere sospeso quando si chiama questo metodo.

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