struktur KS_VIDEOINFOHEADER (ksmedia.h)
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) |