IAVIStream::Metode ReadFormat (vfw.h)

Metode ReadFormat mendapatkan informasi format dari aliran. Mengisi dan mengembalikan struktur dengan data dalam buffer yang ditentukan aplikasi. Jika tidak ada buffer yang disediakan, menentukan ukuran buffer yang diperlukan untuk mengambil buffer data format. Dipanggil ketika aplikasi menggunakan fungsi AVIStreamReadFormat .

Sintaks

HRESULT ReadFormat(
  LONG   lPos,
  LPVOID lpFormat,
  LONG   *lpcbFormat
);

Parameter

lPos

Posisi sampel atau bingkai.

lpFormat

Penunjuk ke buffer untuk data format. Tentukan NULL untuk meminta ukuran buffer yang diperlukan.

lpcbFormat

Penunjuk ke buffer yang menerima ukuran, dalam byte, dari buffer yang ditentukan oleh lpFormat. Ketika metode ini dipanggil, konten parameter ini menunjukkan ukuran buffer yang ditentukan oleh lpFormat. Ketika metode ini mengembalikan kontrol ke aplikasi, konten parameter ini menentukan jumlah data yang dibaca atau ukuran buffer yang diperlukan.

Nilai kembali

Mengembalikan HRESULT yang ditentukan oleh OLE.

Keterangan

Jenis data yang disimpan dalam aliran menentukan informasi format dan struktur yang berisi informasi format. Handler stream harus mengembalikan semua informasi format yang berlaku dalam struktur ini, termasuk informasi palet saat format menggunakan palet. Handler aliran tidak boleh mengembalikan data aliran dengan struktur .

Handler aliran video standar menyediakan informasi format dalam struktur BITMAPINFOHEADER . Handler aliran audio standar menyediakan informasi format dalam struktur PCMWAVEFORMAT . Aliran data lainnya dapat menggunakan struktur lain yang menjelaskan data aliran.

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

HRESULT ReadFormat(LONG lPos, LPVOID lpFormat, 
    LONG *lpcbFormat) 
 

Persyaratan

Lihat juga

File Kustom dan Antarmuka Handler Stream

File Kustom dan Penangan Stream