struktur DD_HALINFO (ddrawint.h)

Artikel
08/23/2023

Struktur DD_HALINFO menjelaskan kemampuan perangkat keras dan driver.

Sintaks

typedef struct _DD_HALINFO {
  DWORD               dwSize;
  VIDEOMEMORYINFO     vmiData;
  DDNTCORECAPS        ddCaps;
  PDD_GETDRIVERINFO   GetDriverInfo;
  DWORD               dwFlags;
  LPVOID              lpD3DGlobalDriverData;
  LPVOID              lpD3DHALCallbacks;
  PDD_D3DBUFCALLBACKS lpD3DBufCallbacks;
} DD_HALINFO, *PDD_HALINFO;

Anggota

dwSize

Menentukan ukuran dalam byte struktur DD_HALINFO ini.

vmiData

Menentukan struktur VIDEOMEMORYINFO yang menjelaskan memori tampilan.

ddCaps

Menentukan struktur DDNTCORECAPS yang berisi kemampuan khusus driver.

GetDriverInfo

Menunjuk ke fungsi DdGetDriverInfo driver. Fungsi ini dipanggil untuk mendapatkan informasi driver Microsoft DirectDraw lebih lanjut. Anggota ini bisa NULL.

dwFlags

Menentukan bendera pembuatan pengandar tampilan. Anggota ini adalah bitwise ATAU dari salah satu nilai berikut:

Bendera	Makna
DDHALINFO_ISPRIMARYDISPLAY	Driver adalah driver tampilan utama.
DDHALINFO_MODEXILLEGAL	Piranti keras ini tidak mendukung mode ModeX.
DDHALINFO_GETDRIVERINFOSET	Anggota GetDriverInfo diatur.
DDHALINFO_GETDRIVERINFO2	Driver mendukung varian GetDriverInfo2 dari GetDriverInfo.

lpD3DGlobalDriverData

Menunjuk ke struktur D3DHAL_GLOBALDRIVERDATA yang menjelaskan kemampuan 3D driver dan perangkatnya.

lpD3DHALCallbacks

Menunjuk ke struktur D3DHAL_CALLBACKS yang diinisialisasi driver.

lpD3DBufCallbacks

Hanya digunakan oleh driver yang ingin menerapkan puncak tingkat driver dan alokasi buffer perintah. Ini biasanya dilakukan karena alasan performa. Anggota lpD3DBufCallbacks adalah penunjuk ke struktur DD_D3DBUFCALLBACKS yang diisi driver dengan panggilan balik yang digunakan untuk mendukung puncak yang dikelola driver dan buffer perintah. Anggota ini biasanya harus diabaikan oleh driver.

Keterangan

GDI mengalokasikan dan menginisialisasi nol struktur DD_HALINFO dan meneruskannya ke rutinitas DrvGetDirectDrawInfo driver untuk diinisialisasi dengan data khusus driver.