Metode IAsyncReader::SyncRead (strmif.h)

[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 SyncRead melakukan bacaan sinkron. Metode memblokir hingga permintaan selesai. Posisi file dan alamat buffer tidak harus diratakan. Jika permintaan tidak selaras, metode melakukan operasi baca yang di-buffer.

Sintaks

HRESULT SyncRead(
  [in]  LONGLONG llPosition,
  [in]  LONG     lLength,
  [out] BYTE     *pBuffer
);

Parameter

[in] llPosition

Menentukan offset byte untuk mulai membaca. Metode gagal jika nilai ini berada di luar akhir file.

[in] lLength

Menentukan jumlah byte yang akan dibaca.

[out] pBuffer

Penunjuk ke buffer yang menerima data.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_FALSE	Diambil lebih sedikit byte daripada yang diminta. (Mungkin akhir file tercapai.)
S_OK	Berhasil.

Keterangan

Metode ini berfungsi bahkan jika filter dihentikan.

Persyaratan

Persyaratan	Nilai
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

IAsyncReader::SyncReadAligned