struktur KS_VIDEOINFO (ksmedia.h)

  • Artikel

Struktur KS_VIDEOINFO menjelaskan informasi bitmap dan warna untuk streaming video.

Sintaks

typedef struct tagKS_VIDEOINFO {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
  union {
    KS_RGBQUAD       bmiColors[KS_iPALETTE_COLORS];
    DWORD            dwBitMasks[KS_iMASK_COLORS];
    KS_TRUECOLORINFO TrueColorInfo;
  };
} KS_VIDEOINFO, *PKS_VIDEOINFO;

Anggota

rcSource

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

rcTarget

Menentukan persegi panjang yang menunjukkan bagian mana dari buffer target yang akan digunakan.

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.

bmiColors[KS_iPALETTE_COLORS]

Array struktur KS_RGBQUAD yang menentukan palet warna video. Setiap struktur mewakili satu warna, yang merupakan kombinasi intensitas merah, hijau, dan biru.

dwBitMasks[KS_iMASK_COLORS]

Array nilai DWORD yang menentukan bitmasks warna benar.

TrueColorInfo

KS_TRUECOLORINFO struktur yang berisi palet warna dan array bitmasks warna.

Keterangan

Struktur ini tidak boleh digunakan kecuali anggota biSize anggota KS_BITMAPINFOHEADER diatur ke sizeof(KS_BITMAPINFOHEADER).

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 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_RGBQUAD

KS_TRUECOLORINFO