struktur KS_VIDEOINFOHEADER (ksmedia.h)

  • Artikel

Struktur KS_VIDEOINFOHEADER menjelaskan bitmap dan informasi warna untuk streaming video.

Sintaks

typedef struct tagKS_VIDEOINFOHEADER {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER, *PKS_VIDEOINFOHEADER;

Anggota

rcSource

Menentukan persegi panjang kliping yang memilih bagian sinyal video aktif yang akan digunakan.

rcTarget

Menentukan persegi panjang yang menentukan jendela video tujuan target.

dwBitRate

Menentukan nilai yang menunjukkan perkiraan laju data aliran video, dalam bit per detik.

dwBitErrorRate

Menentukan nilai yang menunjukkan tingkat kesalahan data aliran video, dalam kesalahan bit per detik.

AvgTimePerFrame

Menentukan waktu rata-rata per bingkai, dalam unit 100 nanodetik.

bmiHeader

Menjelaskan struktur KS_BITMAPINFOHEADER yang berisi informasi warna dan dimensi tentang bitmap gambar video.

Keterangan

Untuk mendeskripsikan streaming video dengan pengaturan bob atau weave, gunakan KS_VIDEOINFOHEADER2.

Struktur KS_VIDEOINFOHEADER identik dengan struktur Microsoft DirectShow VIDEOINFOHEADER.

Filter sumber dapat meminta agar filter sink hanya mengambil bagian video dengan menyediakan nilai yang secara efektif menentukan persegi panjang kliping di anggota rcSource . Namun, jika filter sink tidak memeriksa persegi panjang kliping pada koneksi, filter sink hanya merender semua video, secara efektif mengabaikan informasi kliping apa pun yang diteruskan dari filter sumber ke filter sink.

Idealnya, filter sink memeriksa rcSource dan jika filter sink tidak mendukung ekstraksi gambar, dan persegi panjang tidak kosong, maka ia menolak koneksi. Filter harus menggunakan fungsi Win32 SetRectEmpty untuk mengatur ulang persegi panjang ke semua nol (dan mengatur IsRectEmpty untuk memeriksa persegi panjang nanti).

Anggota rcTarget menentukan persegi panjang tujuan untuk video. Sebagian besar filter sumber mengatur anggota ini ke semua nol. Filter hilir dapat meminta agar video ditempatkan di area tertentu dari buffer yang disediakannya. Dalam hal ini, ini memanggil fungsi Win32 QueryAccept dengan target yang tidak kosong.

Persyaratan

Persyaratan Nilai
Header ksmedia.h (termasuk Ksmedia.h)

Lihat juga

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2