структура DD_HALINFO (ddrawint.h)

Статья
08/23/2023

Структура DD_HALINFO описывает возможности оборудования и драйвера.

Синтаксис

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;

Члены

dwSize

Задает размер этой структуры DD_HALINFO в байтах.

vmiData

Задает структуру VIDEOMEMORYINFO , описывающую память дисплея.

ddCaps

Задает структуру DDNTCORECAPS , содержащую возможности для конкретных драйверов.

GetDriverInfo

Указывает на функцию DdGetDriverInfo драйвера. Эта функция вызывается для получения дополнительных сведений о драйвере Microsoft DirectDraw. Этот элемент может иметь значение NULL.

dwFlags

Указывает флаги создания драйвера дисплея. Этот элемент является побитовой или любого из следующих значений:

Flag	Значение
DDHALINFO_ISPRIMARYDISPLAY	Драйвер является основным драйвером дисплея.
DDHALINFO_MODEXILLEGAL	Это оборудование не поддерживает режимы ModeX.
DDHALINFO_GETDRIVERINFOSET	Задан элемент GetDriverInfo .
DDHALINFO_GETDRIVERINFO2	Драйвер поддерживает вариант GetDriverInfo2.

lpD3DGlobalDriverData

Указывает на структуру D3DHAL_GLOBALDRIVERDATA , описывающую трехмерные возможности драйвера и его устройства.

lpD3DHALCallbacks

Указывает на инициализированную структуру D3DHAL_CALLBACKS драйвера.

lpD3DBufCallbacks

Используется только драйверами, которые хотят реализовать распределение вершин и буфера команд на уровне драйвера. Обычно это делается из соображений производительности. Член lpD3DBufCallbacks — это указатель на структуру DD_D3DBUFCALLBACKS , которую драйвер заполняет обратными вызовами, используемыми для поддержки управляемых драйвером буферов вершин и команд. Этот элемент обычно должен игнорироваться драйвером.