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 |
---|---|
|
Il grafico è stato sospeso correttamente, ma alcuni filtri non hanno completato la transizione dello stato. |
|
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 |