структура DD_MULTISAMPLEQUALITYLEVELSDATA (d3dhal.h)

Статья
02/23/2024

Только DirectX 9.0 и более поздних версий.

DD_MULTISAMPLEQUALITYLEVELSDATA — это структура данных, на которую указывает поле lpvDataDD_GETDRIVERINFODATA для DD_GETDRIVERINFO2DATA запросов с типом D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS.

Синтаксис

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

Члены

gdi2

Задает DD_GETDRIVERINFO2DATA структуру, содержащую данные GetDriverInfo2 .

Format

Использует значение из перечисления D3DFORMAT для указания формата поверхности целевого объекта отрисовки с несколькими выборкой.

bFlip

Указывает тип разрешения. Задайте значение TRUE (1) для разрешения в стиле flip и значение FALSE (0) для разрешения в стиле blt.

MSType

Использует значение из перечисления D3DMULTISAMPLE_TYPE, чтобы указать уровень полной выборки сцены. Если устройство отображения поддерживает маскируемую многонаборку (несколько выборок для многофакторной отрисовки и поддержку антиалиасов), драйвер устройства должен указать количество уровней качества для перечисленного значения D3DMULTISAMPLE_NONMASKABLE (1).

QualityLevels

Получает количество уровней качества с несколькими выборками, поддерживаемых драйвером для заданного формата целевой отрисовки.

Драйвер назначает члену QualityLevels целое число от 1 до 8. Если драйвер завершается сбоем, игнорирует этот D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS запрос или возвращает значение, которое выходит за пределы диапазона, но в противном случае сообщает о поддержке множественной дискретизации, среда выполнения определяет, что количество уровней качества равно 1.

Когда среда выполнения вызывает функции DdCanCreateSurface, DdCreateSurface или D3dCreateSurfaceEx драйвера для создания поверхности, среда выполнения кодирует количество уровней качества с несколькими выборками в три бита (маска DDSCAPS3_MULTISAMPLE_QUALITY_MASK) элемента dwCaps3DDSCAPS2 структуры.

Дополнительные сведения о D3DFORMAT и D3DMULTISAMPLE_TYPE см. в документации по пакету SDK для DirectX.