struktur KS_DATARANGE_VIDEO (ksmedia.h)

  • Artikel

Struktur KS_DATARANGE_VIDEO menjelaskan berbagai aliran video tanpa pengaturan bob atau tenun.

Sintaks

typedef struct tagKS_DATARANGE_VIDEO {
  KSDATARANGE                 DataRange;
  BOOL                        bFixedSizeSamples;
  BOOL                        bTemporalCompression;
  DWORD                       StreamDescriptionFlags;
  DWORD                       MemoryAllocationFlags;
  KS_VIDEO_STREAM_CONFIG_CAPS ConfigCaps;
  KS_VIDEOINFOHEADER          VideoInfoHeader;
} KS_DATARANGE_VIDEO, *PKS_DATARANGE_VIDEO;

Anggota

DataRange

Menentukan pengidentifikasi utama untuk format tersebut.

bFixedSizeSamples

Menentukan bahwa semua sampel berukuran sama jika diatur ke TRUE.

bTemporalCompression

Menentukan apakah setiap sampel dapat berdiri sendiri tanpa mengandalkan sampel sebelumnya atau di masa mendatang.

StreamDescriptionFlags

Tidak digunakan dan harus diatur ke nol.

MemoryAllocationFlags

Tidak digunakan dan harus diatur ke nol.

ConfigCaps

Menentukan konfigurasi aliran, termasuk penskalaan, pemotongan, serta kecepatan bingkai dan data.

VideoInfoHeader

Menentukan detail aliran video.

Keterangan

Struktur KS_DATARANGE_VIDEO digunakan untuk dua tujuan terkait:

  1. Pada waktu inisialisasi minidriver, minidriver mengembalikan array struktur KS_DATARANGE_VIDEO yang mengekspos semua format yang didukung untuk pin tertentu, termasuk opsi pemotongan dan penskalaan yang mungkin.
  2. Ketika format tertentu dipilih oleh klien mode pengguna, anggota (dan pengaturan mereka) dari struktur ini menentukan apakah format yang diusulkan didukung oleh minidriver. Klien mode pengguna memodifikasi konten anggota VideoInfoHeader tetapi harus membiarkan semua anggota lain KS_DATARANGE_VIDEO tidak berubah. Minidriver kemudian memverifikasi parameter yang diminta dan mengembalikan struktur KS_DATAFORMAT_VIDEO. Minidriver kemudian menghitung anggota yang unik untuk format tertentu yang diminta.
Misalnya, aliran yang mendukung format pengambilan RGB16, RGB24, YVU9, dan JPEG mendefinisikan array empat struktur KS_DATAFORMAT_VIDEO.

Persyaratan

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

Lihat juga

KSDATARANGE

KS_VIDEOINFOHEADER

KS_VIDEO_STREAM_CONFIG_CAPS