Metodo IMediaFilter::P ause (strmif.h)

Articolo
07/28/2023

[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 metodo Pause sospende il filtro.

Sintassi

HRESULT Pause();

Valore restituito

Restituisce un valore HRESULT . I valori possibili includono quelli illustrati nella tabella seguente.

Codice restituito	Descrizione
S_FALSE	Transizione non completata.
S_OK	Operazione completata. Transizione completata.

Commenti

Quando un filtro viene sospeso, può ricevere, elaborare e recapitare campioni. Tuttavia, un filtro del renderer accetterà un solo esempio mentre è in pausa. Pertanto, quando il grafico del filtro viene sospeso, i campioni passano attraverso il grafico fino a quando il primo campione non raggiunge il renderer. A questo punto, lo streaming viene sospeso fino a quando non viene chiamato il metodo IMediaFilter::Run . I renderer video visualizzano il primo esempio come fotogramma ancora.

I filtri di acquisizione dinamica non recapitano campioni durante la sospensione, solo durante l'esecuzione.

La transizione dello stato potrebbe essere asincrona. Se il metodo viene restituito prima del completamento della transizione, il valore restituito viene S_FALSE. Un filtro renderer non completa la transizione in pausa fino a quando (1) riceve un campione o (2) riceve una notifica di fine flusso. Mentre la transizione dello stato è in sospeso, IMediaFilter::GetState restituisce VFW_S_STATE_INTERMEDIATE.

Requisiti


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

Vedi anche

Codici di errore e di esito positivo

IBaseFilter

Interfaccia IMediaFilter

Share via