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 |