Struktur DDVIDEOPORTCAPS (dvp.h)
Struktur DDVIDEOPORTCAPS menjelaskan kemampuan dan pembatasan penyelarasan port video perangkat keras.
Sintaks
typedef struct _DDVIDEOPORTCAPS {
DWORD dwSize;
DWORD dwFlags;
DWORD dwMaxWidth;
DWORD dwMaxVBIWidth;
DWORD dwMaxHeight;
DWORD dwVideoPortID;
DWORD dwCaps;
DWORD dwFX;
DWORD dwNumAutoFlipSurfaces;
DWORD dwAlignVideoPortBoundary;
DWORD dwAlignVideoPortPrescaleWidth;
DWORD dwAlignVideoPortCropBoundary;
DWORD dwAlignVideoPortCropWidth;
DWORD dwPreshrinkXStep;
DWORD dwPreshrinkYStep;
DWORD dwNumVBIAutoFlipSurfaces;
DWORD dwNumPreferredAutoflip;
WORD wNumFilterTapsX;
WORD wNumFilterTapsY;
} *LPDDVIDEOPORTCAPS, DDVIDEOPORTCAPS;
Anggota
dwSize
Menentukan ukuran dalam byte struktur.
dwFlags
Tentukan anggota dalam struktur ini yang berisi data yang valid. Anggota ini bisa menjadi bitwise ATAU dari salah satu nilai berikut:
| Bendera | Makna |
|---|---|
| DDVPD_ALIGN |
|
| DDVPD_AUTOFLIP | dwNumAutoFlipSurfaces valid. |
| DDVPD_CAPS | Anggota dwCaps valid. |
| DDVPD_FX | Anggota dwFX valid. |
| DDVPD_HEIGHT | Anggota dwMaxHeight valid. |
| DDVPD_ID | Anggota dwVideoPortID valid. |
| DDVPD_WIDTH | Anggota dwMaxWidth dan dwMaxVBIWidth valid. |
dwMaxWidth
Menentukan lebar bidang maksimum dalam piksel yang didukung oleh port video perangkat keras. Nilai ini biasanya ditentukan oleh jumlah bit dalam register lebar.
dwMaxVBIWidth
Menentukan lebar maksimum, dalam jumlah sampel, dalam baris data VBI yang didukung oleh port video perangkat keras. Nilai ini bisa lebih besar dari lebar bidang normal jika port video perangkat keras mendukung data VBI yang diambil sampelnya secara berlebihan.
dwMaxHeight
Menentukan tinggi bidang maksimum dalam piksel yang didukung oleh port video perangkat keras. Nilai ini biasanya ditentukan oleh jumlah bit dalam register tinggi.
dwVideoPortID
Menentukan ID porta video perangkat keras untuk entri ini. Anggota ini harus menjadi nomor indeks struktur DDVIDEOPORTCAPS ini dalam array tempat anggota lpDDVideoPortCaps dari titik struktur DD_DIRECTDRAW_GLOBAL . Nilai ini berkisar dari 0 hingga (dwMaxVideoPorts - 1). (dwMaxVideoPorts adalah anggota struktur DDCORECAPS .) Jika perangkat hanya mendukung satu port video perangkat keras, anggota ini seharusnya nol.
dwCaps
Menunjukkan sekumpulan bendera yang menentukan kemampuan yang didukung oleh port video perangkat keras ini. Anggota ini bisa menjadi bitwise ATAU dari salah satu nilai berikut:
| Bendera | Makna |
|---|---|
| DDVPCAPS_AUTOFLIP | Flip dapat dilakukan secara otomatis untuk menghindari merobek. |
| DDVPCAPS_COLORCONTROL | Port video perangkat keras dapat melakukan operasi warna pada data masuk sebelum ditulis ke buffer bingkai. |
| DDVPCAPS_INTERLACED | Port video perangkat keras mendukung video terjalin. |
| DDVPCAPS_NONINTERLACED | Port video perangkat keras mendukung video yang tidak terinterlaced. |
| DDVPCAPS_OVERSAMPLEDVBI | Port video perangkat keras dapat menerima data VBI dalam lebar atau format yang berbeda dari data video biasa. |
| DDVPCAPS_READBACKFIELD | Perangkat dapat mengembalikan nilai yang menandakan apakah bidang sinyal terjalin saat ini genap atau ganjil. |
| DDVPCAPS_READBACKLINE | Perangkat dapat mengembalikan jumlah baris video saat ini yang ditulis ke dalam buffer bingkai. |
| DDVPCAPS_SHAREABLE | Diabaikan oleh Microsoft DirectDraw. |
| DDVPCAPS_SKIPEVENFIELDS | Port video perangkat keras dapat secara otomatis membuang bahkan bidang video. |
| DDVPCAPS_SKIPODDFIELDS | Port video perangkat keras dapat secara otomatis membuang bidang video ganjil. |
| DDVPCAPS_SYNCMASTER | Perangkat ini mampu mendorong V-sync grafis dengan driver port video perangkat keras V-sync. |
| DDVPCAPS_SYSTEMMEMORY | Port video perangkat keras dapat menulis data langsung ke memori sistem. |
| DDVPCAPS_VBISURFACE | Data dalam interval pengosongan vertikal dapat ditulis ke permukaan yang berbeda. |
dwFX
Menunjukkan sekumpulan bendera yang menentukan efek yang didukung oleh port video perangkat keras ini. Anggota ini adalah bitwise ATAU dari salah satu nilai berikut:
| Bendera | Makna |
|---|---|
| DDVPFX_CROPTOPDATA | Port video perangkat keras mendukung pemotongan terbatas untuk memangkas data interval vertikal. |
| DDVPFX_CROPX | Port video perangkat keras dapat memangkas data masuk ke arah x sebelum menulisnya ke permukaan. |
| DDVPFX_CROPY | Port video perangkat keras dapat memangkas data masuk ke arah y sebelum menulisnya ke permukaan. |
| DDVPFX_IGNOREVBIXCROP | Port video perangkat keras dapat mengabaikan koordinat pemotongan kiri dan kanan untuk data video saat memangkas data VBI yang diambil alih. |
| DDVPFX_INTERLEAVE | Port video perangkat keras mendukung bidang terjalin yang saling terkait dalam memori. |
| DDVPFX_MIRRORLEFTRIGHT | Port video perangkat keras mendukung pencerminan kiri ke kanan saat data video ditulis ke dalam buffer bingkai. |
| DDVPFX_MIRRORUPDOWN | Port video perangkat keras mendukung pencerminan dari atas ke bawah saat data video ditulis ke dalam buffer bingkai. |
| DDVPFX_PRESHRINKX | Data dapat disusutkan secara acak ke arah x sebelum ditulis ke permukaan. |
| DDVPFX_PRESHRINKXB | Data dapat disusutkan oleh kekuatan negatif 2 (1/2, 1/4, 1/8, dan sebagainya) ke arah x sebelum ditulis ke permukaan. |
| DDVPFX_PRESHRINKXS | Data dapat disusutkan dengan kenaikan 1/dwPreshrinkXStep ke arah x sebelum ditulis ke permukaan. |
| DDVPFX_PRESHRINKY | Data dapat disusutkan secara acak ke arah y sebelum ditulis ke permukaan. |
| DDVPFX_PRESHRINKYB | Data dapat disusutkan oleh kekuatan negatif 2 (1/2, 1/4, 1/8, dan sebagainya) ke arah y sebelum ditulis ke permukaan. |
| DDVPFX_PRESHRINKYS | Data dapat disusutkan dengan kenaikan 1/dwPreshrinkYStep ke arah y sebelum ditulis ke permukaan. |
| DDVPFX_PRESTRETCHX | Data dapat direntangkan secara arbitrer ke arah x sebelum ditulis ke permukaan. |
| DDVPFX_PRESTRETCHXN | Data dapat direntangkan oleh faktor bilangan bulat ke arah x sebelum ditulis ke permukaan. |
| DDVPFX_PRESTRETCHY | Data dapat direntangkan secara acak ke arah y sebelum ditulis ke permukaan. |
| DDVPFX_PRESTRETCHYN | Data dapat direntangkan oleh faktor bilangan bulat ke arah y sebelum ditulis ke permukaan. |
| DDVPFX_VBICONVERT | Data dalam interval pengosongan vertikal dapat dikonversi independen dari data video yang tersisa. |
| DDVPFX_VBINOSCALE | Penskalaan dapat dinonaktifkan untuk data dalam interval kosong vertikal. |
dwNumAutoFlipSurfaces
Menentukan jumlah maksimum permukaan yang didukung dalam rantai autoflip, jika port video perangkat keras mendukung autoflipping. Jika port video perangkat keras tidak mendukung autoflipping, driver harus mengatur anggota ini ke nol.
dwAlignVideoPortBoundary
Menentukan pembatasan perataan byte, dalam byte, di mana port video perangkat keras dapat berorientasi relatif terhadap asal permukaan ke arah x.
dwAlignVideoPortPrescaleWidth
Menentukan pembatasan perataan byte, dalam byte, tentang seberapa luas data port video perangkat keras saat prescaling dilakukan.
dwAlignVideoPortCropBoundary
Menentukan pembatasan perataan byte, dalam byte, untuk koordinat pemotongan kiri.
dwAlignVideoPortCropWidth
Menentukan pembatasan perataan byte, dalam byte, untuk lebar persegi panjang pemotongan.
dwPreshrinkXStep
Menunjukkan bahwa port video perangkat keras dapat menyusutkan lebar data video dalam langkah 1/dwPreshrinkXStep. Anggota ini hanya valid ketika kemampuan DDVPFX_PRESHRINKXS ditentukan.
dwPreshrinkYStep
Menunjukkan bahwa port video perangkat keras dapat menyusutkan tinggi data video dalam langkah 1/dwPreshrinkYStep. Anggota ini hanya valid ketika kemampuan DDVPFX_PRESHRINKYS ditentukan.
dwNumVBIAutoFlipSurfaces
Menentukan jumlah maksimum permukaan yang didukung dalam rantai autoflip, jika port video perangkat keras mendukung autoflipping. Jika port video perangkat keras tidak mendukung autoflipping, driver harus mengatur anggota ini ke nol. Anggota ini bekerja dengan cara yang sama seperti dwNumAutoFlipSurfaces kecuali bahwa itu hanya berkaitan dengan perangkat yang dapat mengirim data VBI ke permukaan yang berbeda dari yang video normal sedang ditulis.
dwNumPreferredAutoflip
Menentukan jumlah permukaan autoflippable yang optimal yang didukung oleh perangkat keras.
wNumFilterTapsX
Menunjukkan jumlah ketukan yang digunakan prescaler ke arah x. Nilai 0 menunjukkan tidak ada preskal, nilai 1 menunjukkan replikasi, dan sebagainya.
wNumFilterTapsY
Menunjukkan jumlah ketukan yang digunakan prescaler ke arah y. Nilai 0 menunjukkan tidak ada preskal, nilai 1 menunjukkan replikasi, dan sebagainya.
Keterangan
Driver melaporkan kemampuan yang dijelaskan oleh struktur DDVIDEOPORTCAPS ketika fungsi DdGetDriverInfo dipanggil dengan GUID GUID_VideoPortCaps.
Persyaratan
| Header | dvp.h (termasuk Dvp.h) |