IAVIStream::Metode baca (vfw.h)

Metode Baca membaca data dari aliran dan menyalinnya ke buffer yang ditentukan aplikasi. Jika tidak ada buffer yang disediakan, buffer menentukan ukuran buffer yang diperlukan untuk mengambil buffer data berikutnya. Dipanggil saat aplikasi menggunakan fungsi AVIStreamRead .

Sintaks

HRESULT Read(
  LONG   lStart,
  LONG   lSamples,
  LPVOID lpBuffer,
  LONG   cbBuffer,
  LONG   *plBytes,
  LONG   *plSamples
);

Parameter

lStart

Memulai sampel atau nomor bingkai untuk dibaca.

lSamples

Jumlah sampel yang akan dibaca.

lpBuffer

Arahkan ke buffer yang ditentukan aplikasi untuk berisi data aliran. Anda juga dapat menentukan NULL untuk meminta ukuran buffer yang diperlukan. Banyak aplikasi mendahului setiap operasi baca dengan kueri untuk ukuran buffer untuk melihat seberapa besar buffer diperlukan.

cbBuffer

Ukuran, dalam byte, dari buffer yang ditentukan oleh lpBuffer.

plBytes

Penunjuk ke buffer yang menerima jumlah byte yang dibaca.

plSamples

Pointer ke buffer yang menerima jumlah sampel yang dibaca.

Mengembalikan nilai

Mengembalikan AVIERR_OK jika berhasil atau AVIERR_BUFFERTOOSMALL jika buffer tidak cukup besar untuk menyimpan data. Jika berhasil, Read juga mengembalikan buffer data dengan jumlah bingkai (sampel) yang disertakan dalam buffer atau ukuran buffer yang diperlukan, dalam byte.

Keterangan

Untuk handler yang ditulis dalam C++, Read memiliki sintaks berikut:

HRESULT Read(LONG lStart, LONG lSamples, 
    LPVOID lpBuffer, LONG cbBuffer, 
    LONG *plBytes, LONG *plSamples); 
 

Persyaratan

Lihat juga

Antarmuka Penangan File dan Aliran Kustom

Penangan File dan Aliran Kustom