Metode IMediaEvent::WaitForCompletion (control.h)

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode WaitForCompletion menunggu grafik filter merender semua data yang tersedia. Grafik filter harus berjalan atau metode gagal.

Sintaks

HRESULT WaitForCompletion(
  [in]  long msTimeout,
  [out] long *pEvCode
);

Parameter

[in] msTimeout

Interval waktu habis, dalam milidetik. Lewati nol untuk segera kembali. Teruskan nilai INFINITE untuk memblokir tanpa batas waktu.

[out] pEvCode

Penunjuk ke variabel yang menerima kode peristiwa. Lihat Keterangan untuk informasi selengkapnya.

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_ABORT	Waktu habis kedaluwarsa.
VFW_E_WRONG_STATE	Grafik filter tidak berjalan.

Keterangan

Metode ini memblokir hingga waktu habis, atau salah satu peristiwa berikut terjadi:

Selama menunggu, metode membuang semua pemberitahuan peristiwa lainnya.

Jika nilai yang dikembalikan S_OK, parameter pEvCode menerima kode peristiwa yang mengakhiri penantian. Saat metode kembali, grafik filter masih berjalan. Aplikasi dapat menjeda atau menghentikan grafik, sebagaimana mewajarinya.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	control.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IMediaEvent

Bagikan melalui