Metodo IMediaEvent::WaitForCompletion (control.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 WaitForCompletion metodo attende che il grafico del filtro venga eseguito il rendering di tutti i dati disponibili. Il grafico del filtro deve essere in esecuzione o il metodo ha esito negativo.
Sintassi
HRESULT WaitForCompletion(
[in] long msTimeout,
[out] long *pEvCode
);
Parametri
[in] msTimeout
Intervallo di timeout, in millisecondi. Passare zero per restituire immediatamente. Passare il valore INFINITE per bloccare in modo indefinito.
[out] pEvCode
Puntatore a una variabile che riceve un codice evento. Per ulteriori informazioni, vedere la sezione Osservazioni.
Valore restituito
Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Timeout scaduto. |
|
Il grafico del filtro non è in esecuzione. |
Commenti
Questo metodo blocca fino alla scadenza del timeout o si verifica uno degli eventi seguenti:
Durante l'attesa, il metodo elimina tutte le altre notifiche degli eventi.Se il valore restituito è S_OK, il parametro pEvCode riceve il codice evento che ha terminato l'attesa. Quando il metodo restituisce, il grafico del filtro è ancora in esecuzione. L'applicazione può sospendere o arrestare il grafico, in base alle esigenze.
Requisiti
| 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 (includere Dshow.h) |
| Libreria | Strmiids.lib |