struktur D3DDEVICEDESC_V1 (d3dhal.h)

Artikel
03/08/2023

D3DDeviceDesc_V1 usang di DirectX 8.0 dan versi yang lebih baru; lihat Keterangan. Struktur ini menjelaskan kemampuan 3D perangkat.

Sintaks

typedef struct _D3DDeviceDesc_V1 {
  DWORD            dwSize;
  DWORD            dwFlags;
  D3DCOLORMODEL    dcmColorModel;
  DWORD            dwDevCaps;
  D3DTRANSFORMCAPS dtcTransformCaps;
  BOOL             bClipping;
  D3DLIGHTINGCAPS  dlcLightingCaps;
  D3DPRIMCAPS      dpcLineCaps;
  D3DPRIMCAPS      dpcTriCaps;
  DWORD            dwDeviceRenderBitDepth;
  DWORD            dwDeviceZBufferBitDepth;
  DWORD            dwMaxBufferSize;
  DWORD            dwMaxVertexCount;
} D3DDEVICEDESC_V1, *LPD3DDEVICEDESC_V1;

Anggota

dwSize

Menentukan ukuran dalam byte struktur D3DDEVICEDESC_V1 ini.

dwFlags

Mengidentifikasi anggota struktur ini yang berisi data yang valid. Anggota ini bisa menjadi bitwise ATAU dari salah satu nilai berikut:

Nilai	Makna
D3DDD_BCLIPPING	Anggota bClipping berisi data yang valid.
D3DDD_COLORMODEL	Anggota dcmColorModel berisi data yang valid.
D3DDD_DEVCAPS	Anggota dwDevCaps berisi data yang valid.
D3DDD_DEVICERENDERBITDEPTH	dwDeviceRenderBitDepthmember berisi data yang valid.
D3DDD_DEVICEZBUFFERBITDEPTH	dwDeviceZBufferBitDepthmember berisi data yang valid.
D3DDD_LIGHTINGCAPS	Anggota dlcLightingCaps berisi data yang valid.
D3DDD_LINECAPS	Anggota dpcLineCaps berisi data yang valid.
D3DDD_MAXBUFFERSIZE	Anggota dwMaxBufferSize berisi data yang valid.
D3DDD_MAXVERTEXCOUNT	Anggota dwMaxVertexCount berisi data yang valid.
D3DDD_TRANSFORMCAPS	Anggota dtcTransformCaps berisi data yang valid.
D3DDD_TRICAPS	Anggota dpcTriCaps berisi data yang valid.

dcmColorModel

Menentukan model warna perangkat.

dwDevCaps

Mengidentifikasi kemampuan perangkat. Anggota ini bisa menjadi bitwise ATAU dari salah satu nilai berikut:

Nilai	Makna
D3DDEVCAPS_CANBLTSYSTONONLOCAL	Perangkat ini mendukung TexBlt dari memori sistem ke memori video sublokal.
D3DDEVCAPS_CANRENDERAFTERFLIP	Perangkat dapat mengantre perintah penyajian setelah halaman membalik. Perangkat harus mendukung kemampuan ini pada Windows 2000 dan yang lebih baru, yang berarti bahwa driver akan selalu mengatur bendera ini.
D3DDEVCAPS_DRAWPRIMITIVES2	Perangkat dapat mendukung D3dDrawPrimitives2 .
D3DDEVCAPS_DRAWPRIMITIVES2EX	Perangkat dapat mendukung Extended D3dDrawPrimitives2 ; yaitu driver yang mematuhi DX7.
D3DDEVCAPS_DRAWPRIMTLVERTEX	Perangkat dapat menggambar primitif TLVERTEX. Bendera ini kedaluarsa tetapi harus diatur oleh driver.
D3DDEVCAPS_EXECUTESYSTEMMEMORY	Perangkat dapat menggunakan buffer eksekusi dari memori sistem. Driver harus selalu mengatur bit ini.
D3DDEVCAPS_EXECUTEVIDEOMEMORY	Perangkat dapat menggunakan buffer eksekusi dari memori tampilan. Driver tidak boleh mengatur bit ini.
D3DDEVCAPS_FLOATTLVERTEX	Perangkat menerima floating-point untuk data vertex posttransform. Bendera ini kedaluarsa tetapi harus diatur oleh driver.
D3DDEVCAPS_HWRASTERIZATION	Perangkat ini memiliki akselerasi perangkat keras untuk rasterisasi.
D3DDEVCAPS_HWTRANSFORMANDLIGHT	Perangkat dapat mendukung transformasi dan pencahayaan dalam perangkat keras. D3DDEVCAPS_DRAWPRIMITIVES2EX juga harus diatur.
D3DDEVCAPS_SEPARATETEXTUREMEMORIES	Perangkat ini berteksur dari kumpulan memori terpisah. Mengatur bit kemampuan ini menunjukkan ke DirectX 8.0 dan versi aplikasi yang lebih baru bahwa mereka dinonaktifkan secara bersamaan menggunakan beberapa tekstur.
D3DDEVCAPS_SORTDECREASINGZ	Perangkat memerlukan data yang diurutkan untuk mengurangi kedalaman.
D3DDEVCAPS_SORTEXACT	Perangkat membutuhkan data yang diurutkan dengan tepat.
D3DDEVCAPS_SORTINCREASINGZ	Perangkat membutuhkan data yang diurutkan untuk meningkatkan kedalaman.
D3DDEVCAPS_TEXTURENONLOCALVIDEOMEMORY	Perangkat dapat bertekstur dari memori video nonlokal.
D3DDEVCAPS_TLVERTEXSYSTEMMEMORY	Perangkat dapat menggunakan buffer dari memori sistem untuk puncak yang diubah dan menyala. Bendera ini kedaluarsa tetapi harus diatur oleh driver.
D3DDEVCAPS_TLVERTEXVIDEOMEMORY	Perangkat dapat menggunakan buffer dari memori tampilan untuk sudut yang diubah dan menyala. Bendera ini usang dan tidak boleh diatur oleh driver.
D3DDEVCAPS_TEXTURESYSTEMMEMORY	Perangkat dapat mengambil tekstur dari memori sistem.
D3DDEVCAPS_TEXTUREVIDEOMEMORY	Perangkat dapat mengambil tekstur dari memori perangkat.

dtcTransformCaps

Menentukan struktur D3DTRANSFORMCAPS yang menentukan kemampuan transformasi perangkat. Driver harus mengatur anggota dwCaps dari struktur tersebut ke nol.

bClipping

Atur ke TRUE oleh driver jika perangkat dapat melakukan kliping 3D.

dlcLightingCaps

Menentukan kemampuan pencahayaan perangkat. Ini adalah struktur D3DLIGHTINGCAPS . Driver harus mengatur anggota dwCaps, dwLightingModel, dan dwNumLights dari struktur tersebut ke nol.

dpcLineCaps

Menentukan struktur D3DPRIMCAPS yang menentukan kemampuan menggambar perangkat untuk primitif garis.

dpcTriCaps

Menentukan struktur D3DPRIMCAPS yang menentukan kemampuan menggambar perangkat untuk primitif segitiga.

dwDeviceRenderBitDepth

Menentukan kedalaman bit penyajian perangkat. Anggota ini bisa menjadi bitwise ATAU dari konstanta kedalaman bit DirectDraw berikut: DDBD_8, DDBD_16, DDBD_24, atau DDBD_32.

dwDeviceZBufferBitDepth

Menentukan kedalaman bit z-buffer perangkat. Anggota ini bisa menjadi bitwise ATAU dari konstanta kedalaman bit DirectDraw berikut: DDBD_8, DDBD_16, DDBD_24, atau DDBD_32.

dwMaxBufferSize

Harus diatur ke nol.

dwMaxVertexCount

DirectX 7 dan versi yang lebih baru

DirectX 6

Keterangan

Struktur ini telah digantikan oleh D3DCAPS8 (lihat dokumentasi DirectX 8.0 SDK) untuk runtime DirectX 8.0 dan yang lebih baru, tetapi diperlukan untuk kompatibilitas runtime warisan (DirectX 7.0 dan yang lebih lama). Lihat Melaporkan Kemampuan DirectX 8.0 Style Direct3D untuk detailnya.

Fungsi DrvGetDirectDrawInfo driver mengembalikan informasi ini dalam struktur D3DHAL_GLOBALDRIVERDATA tempat anggota lpD3DGlobalDriverData dari struktur DD_HALINFO menunjuk ke.

Runtime Direct3D membangun struktur D3DDEVICEDESC7 tingkat aplikasi (di dokumentasi Microsoft Windows SDK) dari informasi yang dikembalikan dalam struktur D3DDEVICEDESC_V1 dan kemampuan yang diperluas yang dikueri melalui fungsi DdGetDriverInfo driver. Meskipun beberapa bendera dwDevCaps usang di tingkat driver, driver harus mengaturnya dengan tepat agar aplikasi berfungsi dengan benar.