Struktur AVISTREAMINFOA (vfw.h)

Struktur AVISTREAMINFO berisi informasi untuk satu aliran.

Sintaksis

typedef struct _AVISTREAMINFOA {
  DWORD fccType;
  DWORD fccHandler;
  DWORD dwFlags;
  DWORD dwCaps;
  WORD  wPriority;
  WORD  wLanguage;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwStart;
  DWORD dwLength;
  DWORD dwInitialFrames;
  DWORD dwSuggestedBufferSize;
  DWORD dwQuality;
  DWORD dwSampleSize;
  RECT  rcFrame;
  DWORD dwEditCount;
  DWORD dwFormatChangeCount;
  char  szName[64];
} AVISTREAMINFOA, *LPAVISTREAMINFOA;

Anggota

fccType

Kode empat karakter yang menunjukkan jenis aliran. Konstanta berikut telah ditentukan untuk data yang umumnya ditemukan di aliran AVI:

fccHandler

Kode empat karakter handler kompresor yang akan mengompres aliran video ini saat disimpan (misalnya, mmioFOURCC ('M','S','V','C')). Anggota ini tidak digunakan untuk aliran audio.

dwFlags

Bendera yang berlaku untuk aliran. Bit dalam kata berurutan tinggi dari bendera ini khusus untuk jenis data yang terkandung dalam aliran. Bendera berikut didefinisikan:

dwCaps

Bendera kemampuan; saat ini tidak digunakan.

wPriority

Prioritas aliran.

wLanguage

Bahasa aliran.

dwScale

Skala waktu yang berlaku untuk aliran. Membandingkan dwRate dengan dwScale memberikan laju pemutaran dalam jumlah sampel per detik.

Untuk aliran video, laju ini harus berupa kecepatan bingkai. Untuk aliran audio, laju ini harus sesuai dengan ukuran blok audio (nBlockAlign anggotaWAVEFORMAT atau struktur PCMWAVEFORMAT), yang untuk audio PCM (Modulasi Kode Pulse) mengurangi laju sampel.

dwRate

Beri peringkat dalam format bilangan bulat. Untuk mendapatkan laju dalam sampel per detik, bagi nilai ini dengan nilai dalam dwScale.

dwStart

Nomor sampel bingkai pertama file AVI. Unit didefinisikan oleh dwRate dan dwScale. Biasanya, ini nol, tetapi dapat menentukan waktu penundaan untuk aliran yang tidak dimulai bersamaan dengan file.

Rilis 1.0 alat AVI tidak mendukung waktu mulai nonzero.

dwLength

Panjang aliran ini. Unit didefinisikan oleh dwRate dan dwScale.

dwInitialFrames

Audio condong. Anggota ini menentukan berapa banyak untuk condong data audio di depan bingkai video dalam file yang saling terkait. Biasanya, ini sekitar 0,75 detik.

dwSuggestedBufferSize

Ukuran buffer yang direkomendasikan, dalam byte, untuk aliran. Biasanya, anggota ini berisi nilai yang sesuai dengan potongan terbesar dalam aliran. Menggunakan ukuran buffer yang benar membuat pemutaran lebih efisien. Gunakan nol jika Anda tidak tahu ukuran buffer yang benar.

dwQuality

Indikator kualitas data video dalam aliran. Kualitas dinyatakan sebagai angka antara 0 dan 10.000. Untuk data terkompresi, ini biasanya mewakili nilai parameter kualitas yang diteruskan ke perangkat lunak kompresi. Jika diatur ke –1, driver menggunakan nilai kualitas default.

dwSampleSize

Ukuran, dalam byte, dari satu sampel data. Jika nilai anggota ini nol, sampel dapat bervariasi dalam ukuran dan setiap sampel data (seperti bingkai video) harus dalam potongan terpisah. Nilai bukan nol menunjukkan bahwa beberapa sampel data dapat dikelompokkan ke dalam satu gugus dalam file.

Untuk streaming video, angka ini biasanya nol, meskipun bisa nonzero jika semua bingkai video berukuran sama. Untuk aliran audio, angka ini harus sama dengan nBlockAlign anggota WAVEFORMAT atau WAVEFORMATEX struktur yang menjelaskan audio.

rcFrame

Dimensi persegi panjang tujuan video. Nilai mewakili koordinat sudut kiri atas, tinggi, dan lebar persegi panjang.

dwEditCount

Berapa kali aliran telah diedit. Handler aliran mempertahankan jumlah ini.

dwFormatChangeCount

Berapa kali format aliran telah berubah. Handler aliran mempertahankan jumlah ini.

szName[64]

String yang dihentikan null berisi deskripsi aliran.

Komentar

Persyaratan

Lihat juga

Fungsi dan Makro AVIFile

struktur AVIFile

PCMWAVEFORMAT

WAVEFORMAT

WAVEFORMATEX

mmioFOURCC