struktur DD_MULTISAMPLEQUALITYLEVELSDATA (d3dhal.h)

Artikel
02/26/2024

DirectX 9.0 dan versi yang lebih baru saja.

DD_MULTISAMPLEQUALITYLEVELSDATA adalah struktur data yang diacu oleh bidang lpvDataDD_GETDRIVERINFODATA untuk kueri DD_GETDRIVERINFO2DATA dengan jenis D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS.

Sintaks

typedef struct _DD_MULTISAMPLEQUALITYLEVELSDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  D3DFORMAT             Format;
  BOOL                  bFlip : 1;
  D3DMULTISAMPLE_TYPE   MSType : 31;
  DWORD                 QualityLevels;
} DD_MULTISAMPLEQUALITYLEVELSDATA;

Anggota

gdi2

Menentukan struktur DD_GETDRIVERINFO2DATA yang berisi data GetDriverInfo2 .

Format

Menggunakan nilai dari enumerasi D3DFORMAT untuk menentukan format permukaan target render beberapa sampel.

bFlip

Menunjukkan jenis resolusi. Atur ke TRUE (1) untuk resolusi gaya balik dan ke FALSE (0) untuk resolusi gaya blt.

MSType

Menggunakan nilai dari enumerasi D3DMULTISAMPLE_TYPE untuk menentukan tingkat multisampling adegan penuh. Jika perangkat tampilan mendukung multisampling yang dapat ditutupi (lebih dari satu sampel untuk format target render multi-sampel ditambah dukungan antialias), driver untuk perangkat harus memberikan jumlah tingkat kualitas untuk nilai enumerasi D3DMULTISAMPLE_NONMASKABLE (1).

QualityLevels

Menerima jumlah tingkat kualitas beberapa sampel yang didukung driver untuk format target render yang diberikan.

Keterangan

Driver menetapkan bilangan bulat dari 1 hingga 8 ke anggota QualityLevels . Jika driver gagal, mengabaikan kueri D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS ini, atau mengembalikan nilai yang berada di luar rentang, tetapi jika tidak melaporkan bahwa driver mendukung multisampling, maka runtime menentukan bahwa jumlah tingkat kualitas adalah 1.

Ketika runtime memanggil fungsi DdCanCreateSurface, DdCreateSurface, atau D3dCreateSurfaceEx driver untuk membuat permukaan, runtime mengodekan jumlah tingkat kualitas beberapa sampel menjadi tiga bit (masker DDSCAPS3_MULTISAMPLE_QUALITY_MASK) dari anggota dwCaps3 dari struktur DDSCAPS2 .

Untuk informasi selengkapnya tentang D3DFORMAT dan D3DMULTISAMPLE_TYPE, lihat dokumentasi DirectX SDK.