Condividi tramite


Metodo IMediaControl::Stop (control.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il Stop metodo arresta tutti i filtri nel grafico.

Sintassi

HRESULT Stop();

Valore restituito

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

Commenti

Se il grafico è in esecuzione, questo metodo sospende il grafico prima di arrestarlo. Durante la sospensione, i renderer video possono copiare il fotogramma corrente da visualizzare come frame poster.

Questo metodo non cerca all'inizio del flusso. Se chiami questo metodo e chiami il metodo IMediaControl::Run , la riproduzione riprende dalla posizione arrestata. Per eseguire la ricerca, usare l'interfaccia IMediaSeeking .

Filter Graph Manager sospende tutti i filtri nel grafico e quindi chiama il metodo IMediaFilter::Stop su tutti i filtri, senza attendere il completamento delle operazioni di sospensione. Pertanto, alcuni filtri potrebbero avere il metodo Stop chiamato prima di completare l'operazione di sospensione. Se si sviluppa un filtro di rendering personalizzato, potrebbe essere necessario gestire questo caso sospendo il filtro se riceve un comando di arresto in uno stato di esecuzione. Tuttavia, la maggior parte dei filtri non deve eseguire alcuna azione speciale in questo senso.

Requisiti

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

Vedi anche

Codici di errore e di esito positivo

Interfaccia IMediaControl

StopWhenReady