Metode IAsyncReader::WaitForNext (strmif.h)

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 WaitForNext menunggu permintaan baca tertunda berikutnya selesai.

Sintaks

HRESULT WaitForNext(
  [in]  DWORD        dwTimeout,
  [out] IMediaSample **ppSample,
  [out] DWORD_PTR    *pdwUser
);

Parameter

[in] dwTimeout

Menentukan waktu habis dalam milidetik. Gunakan nilai INFINITE untuk menunggu tanpa batas waktu

[out] ppSample

Alamat variabel yang menerima penunjuk antarmuka IMediaSample .

[out] pdwUser

Penunjuk ke variabel yang menerima nilai parameter dwUser yang ditentukan dalam metode IAsyncReader::Request .

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
VFW_E_TIMEOUT	Waktu habis kedaluwarsa, atau pin memerah.
VFW_E_WRONG_STATE	Pinnya menyiram.
E_FAIL	Terjadi kesalahan baca.
S_OK	Berhasil.
S_FALSE	Mencapai akhir file; mengambil lebih sedikit byte daripada yang diminta.

Keterangan

Jika metode berhasil, parameter ppSample berisi pointer ke sampel media, yang buffer-nya menyimpan data yang diminta. Panggil metode IMediaSample::GetTime dan bagi hasilnya dengan 10.000.000 untuk menentukan byte mulai dan berhenti. Sampel dapat dikembalikan secara tidak berurutan. Rilis sampel saat Anda selesai memproses data.

Metode gagal jika pin sedang dibersihkan. Namun, ini dapat mengembalikan sampel kosong di ppSample. Jika *ppSample bukan NULL, lepaskan sampel dan buang. Untuk informasi selengkapnya, lihat IAsyncReader::BeginFlush.

Jika terjadi kesalahan baca, filter sumber mengirimkan peristiwa kesalahan ke Filter Graph Manager; penelepon tidak perlu memberi sinyal kesalahan.

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	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IAsyncReader

Bagikan melalui