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

Sintassi

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

Parametri

[in] pStartFilter

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

[in] pEndFilter

Puntatore al 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_RUNNING o un altro valore HRESULT .

Commenti

Se questo metodo non può cambiare un determinato filtro in uno stato in esecuzione, lascia tutti i filtri in uno stato arrestato. Il grafico del filtro deve essere in esecuzione 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