Metodo IMediaControl::P ause (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 Pause metodo sospende tutti i filtri nel grafico dei filtri.

Sintassi

HRESULT Pause();

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
S_FALSE
Il grafico è stato sospeso correttamente, ma alcuni filtri non hanno completato la transizione dello stato.
S_OK
Tutti i filtri nel grafico hanno completato la transizione a uno stato sospeso.

Commenti

La sospensione del grafico del filtro indica il grafico per il rendering immediato quando il grafico viene eseguito successivamente. Mentre il grafico è sospeso, filtra i dati di elaborazione, ma non ne esegue il rendering. I dati vengono inseriti nel grafico ed elaborati dai filtri di trasformazione per quanto riguarda il buffering consentito, ma i filtri del renderer non eseguono il rendering dei dati. Tuttavia, i renderer video visualizzano un frame poster statico del primo esempio.

Se il metodo restituisce S_FALSE, chiamare il metodo IMediaControl::GetState per attendere il completamento della transizione dello stato o verificare se la transizione è stata completata. Quando si chiama Pause per visualizzare il primo fotogramma di un file video, seguirlo sempre immediatamente con una chiamata a GetState per assicurarsi che la transizione di stato sia stata completata. In caso contrario, il rettangolo video viene dipinto nero.

Se il metodo ha esito negativo, arresta il grafico prima di restituire.

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

IMediaControl::StopWhenReady