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

Статья
02/06/2025

Только версии 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) для разрешения стилей перелистывания и FALSE (0) для разрешения стиля blt.

MSType

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

QualityLevels

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

Замечания

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

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

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