Struktur DDVIDEOPORTINFO (dvp.h)

Artikel
03/05/2024

Struktur DDVIDEOPORTINFO menjelaskan bagaimana driver harus mentransfer data video ke permukaan (atau ke permukaan); DDVIDEOPORTINFO adalah anggota struktur DD_VIDEOPORT_LOCAL .

Sintaks

typedef struct _DDVIDEOPORTINFO {
  DWORD           dwSize;
  DWORD           dwOriginX;
  DWORD           dwOriginY;
  DWORD           dwVPFlags;
  RECT            rCrop;
  DWORD           dwPrescaleWidth;
  DWORD           dwPrescaleHeight;
  LPDDPIXELFORMAT lpddpfInputFormat;
  LPDDPIXELFORMAT lpddpfVBIInputFormat;
  LPDDPIXELFORMAT lpddpfVBIOutputFormat;
  DWORD           dwVBIHeight;
  ULONG_PTR       dwReserved1;
  ULONG_PTR       dwReserved2;
} *LPDDVIDEOPORTINFO, DDVIDEOPORTINFO;

Anggota

dwSize

Menentukan ukuran dalam byte struktur. Anggota ini harus diinisialisasi sebelum struktur digunakan.

dwOriginX

Menunjukkan penempatan x data video di dalam permukaan, dalam piksel. Offset ini berlaku untuk semua permukaan saat autoflipping diminta.

dwOriginY

Menunjukkan penempatan y data video di dalam permukaan, dalam piksel. Offset ini berlaku untuk semua permukaan saat autoflipping diminta.

dwVPFlags

Menunjukkan sekumpulan bendera yang menentukan bagaimana driver harus mentransfer data video. Anggota ini bisa menjadi bitwise ATAU dari nilai berikut:

Bendera	Makna
DDVP_AUTOFLIP	Lakukan pembalikan otomatis. Pembalik otomatis dilakukan di antara permukaan overlay yang terpasang pada port video perangkat keras dan permukaan overlay yang melekat pada permukaan. Urutan balik adalah urutan di mana permukaan overlay terpasang.
DDVP_CONVERT	Data video dan permukaan target memiliki format yang berbeda. Driver harus mengonversi data video ke format format permukaan target.
DDVP_CROP	Driver harus memangkas data video dan VBI menggunakan persegi panjang di anggota rCrop .
DDVP_IGNOREVBIXCROP	Driver harus mengabaikan koordinat pemotongan kiri dan kanan saat memangkas data VBI.
DDVP_INTERLEAVE	Bidang terjalin dari data video dan VBI harus diselingi dalam memori.
DDVP_MIRRORLEFTRIGHT	Data video harus dicerminkan dari kiri ke kanan karena ditulis ke dalam buffer bingkai.
DDVP_MIRRORUPDOWN	Data video harus dicerminkan dari atas ke bawah karena ditulis ke dalam buffer bingkai.
DDVP_NOINTERLEAVE	Jika bendera DDVP_INTERLEAVE diatur, driver harus menjalin data video saja; artinya, driver tidak boleh menjalin data VBI.
DDVP_OVERRIDEBOBWEAVE	Keputusan bob dan weave tidak boleh ditimpa oleh antarmuka lain. Jika bendera ini diatur, Microsoft DirectDraw tidak mengizinkan driver mode kernel untuk menggunakan fungsionalitas transportasi video mode kernel untuk mengalihkan perangkat keras antara mode bob dan tenun.
DDVP_PRESCALE	Lakukan prescaling/zooming berdasarkan anggota dwPrescaleWidth dan dwPrescaleHeight . Driver harus menskalakan hanya data video jika DDVP_VBINOSCALE diatur; jika tidak, itu harus mendahului data video dan VBI.
DDVP_SKIPEVENFIELDS	Abaikan input bidang genap untuk data video dan VBI.
DDVP_SKIPODDFIELDS	Abaikan input bidang ganjil untuk data video dan VBI.
DDVP_SYNCMASTER	Dorong grafik VSYNC menggunakan port video perangkat keras VSYNC.
DDVP_VBICONVERT	Struktur DDPIXELFORMAT tempat poin anggota lpddpfVBIOutputFormat berisi data yang harus digunakan untuk mengonversi data dalam interval kosong vertikal.
DDVP_VBINOSCALE	Data dalam interval pengosongan vertikal tidak boleh diskalakan.

rCrop

Menentukan struktur RECT yang menentukan persegi panjang pemotongan dalam piksel. Anggota ini berisi persegi panjang yang valid ketika bendera DDVP_CROP diatur dalam anggota dwVPFlags .

dwPrescaleWidth

Menentukan lebar dalam piksel tempat data video dan VBI harus diskalakan atau diperbesar. Misalnya, jika data video lebarnya 720 piksel dan klien meminta pemotongan lebar menjadi dua, klien menentukan 360 dalam dwPrescaleWidth. Anggota ini berisi lebar yang valid ketika bendera DDVP_PRESCALE diatur dalam anggota dwVPFlags .

dwPrescaleHeight

Menentukan tinggi piksel tempat data video dan VBI harus diskalakan atau diperbesar. Misalnya, jika data video lebarnya 240 piksel dan klien meminta pemotongan lebar menjadi dua, klien menentukan 120 di dwPrescaleHeight. Anggota ini berisi lebar yang valid ketika bendera DDVP_PRESCALE diatur dalam anggota dwVPFlags .

lpddpfInputFormat

Menunjuk ke struktur DDPIXELFORMAT yang menentukan format data video yang akan ditulis ke objek ekstensi port video (VPE ). Format ini dapat berbeda dari format permukaan target jika objek VPE melakukan konversi.

lpddpfVBIInputFormat

Menunjuk ke struktur DDPIXELFORMAT yang menentukan format input data dalam interval kosong vertikal.

lpddpfVBIOutputFormat

Menunjuk ke struktur DDPIXELFORMAT yang menentukan format output data dalam interval kosong vertikal.

dwVBIHeight

Menentukan jumlah baris data dalam interval kosong vertikal.

dwReserved1

Dicadangkan untuk penggunaan sistem dan harus diabaikan oleh driver.

dwReserved2

Dicadangkan untuk penggunaan sistem dan harus diabaikan oleh driver.

Keterangan

Semua anggota struktur ini ditetapkan oleh klien dan driver tidak boleh mengubahnya. Klien biasanya adalah mixer overlay.

Persyaratan

Persyaratan	Nilai
Header	dvp.h (termasuk Dvp.h)

Lihat juga

DDPIXELFORMAT

DD_VIDEOPORT_LOCAL

Bagikan melalui