Функция DrvGetDirectDrawInfo (winddi.h)

Статья
03/04/2024

Функция DrvGetDirectDrawInfo возвращает возможности графического оборудования.

Синтаксис

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

Параметры

dhpdev

Дескриптор PDEV , возвращенный подпрограммой DrvEnablePDEV водителя.

pHalInfo

Указывает на структуру DD_HALINFO , в которой драйвер должен возвращать поддерживаемые им аппаратные возможности.

pdwNumHeaps

Указывает на расположение, в котором драйвер должен возвращать количество структур VIDEOMEMORY, на которые указывает pvmList.

pvmList

Указывает на массив структур VIDEOMEMORY , в которых драйвер должен возвращать сведения о каждом блоке памяти дисплея, которым он управляет. Драйвер должен игнорировать этот параметр, если он имеет значение NULL.

pdwNumFourCCCodes

Указывает на расположение, в котором драйвер должен возвращать количество DWORD, на которые указывает pdwFourCC.

pdwFourCC

Указывает на массив DWORD, в котором драйвер должен возвращать сведения о каждом fourcc , который он поддерживает. Драйвер должен игнорировать этот параметр, если он имеет значение NULL.

Возвращаемое значение

DrvGetDirectDrawInfo возвращает значение TRUE в случае успешного выполнения. В противном случае возвращается значение FALSE.

Если pvmList и pdwFourCC имеют значение NULL:
1. Зарезервируйте память вне экрана для использования DirectDraw.
2. Запишите количество кучи памяти для отображения драйверов и поддерживаемых FOURCCs в pdwNumHeaps и pdwNumFourCC соответственно.
Если pvmList и pdwFourCC не имеют значения NULL:
1. Запишите количество кучи памяти для отображения драйверов и поддерживаемых FOURCCs в pdwNumHeaps и pdwNumFourCC соответственно.
2. Для каждой структуры VIDEOMEMORY в списке, на которую указывает pvmList , заполните соответствующие элементы, чтобы описать конкретный блок отображаемой памяти. Список структур предоставляет DirectDraw с полным описанием памяти драйвера за кадром.
Инициализируйте члены структуры DD_HALINFO с информацией о драйвере следующим образом:
1. Инициализируйте соответствующие элементы структуры VIDEOMEMORYINFO в vmiData , чтобы описать общие характеристики памяти дисплея.
2. Инициализируйте соответствующие элементы структуры DDCORECAPS в ddCaps , чтобы описать возможности оборудования.
3. Если драйвер реализует функцию DdGetDriverInfo , задайте для getDriverInfo указатель на нее, а для dwFlags задайте DDHALINFO_GETDRIVERINFOSET.