Metodo IMediaEvent::WaitForCompletion (control.h)

Articolo
07/28/2023

[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
S_OK	Operazione completata.
E_ABORT	Timeout scaduto.
VFW_E_WRONG_STATE	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

Vedi anche

Codici errore e esito positivo

Interfaccia IMediaEvent

Condividi tramite