функция обратного вызова PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS (d3d10umddi.h)

  • Статья

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

Синтаксис

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3dwddm13DdiCheckmultisamplequalitylevels;

void Pfnd3dwddm13DdiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE hDevice,
  DXGI_FORMAT Format,
  UINT SampleCount,
  UINT Flags,
  UINT *pNumQualityLevels
)
{...}

Параметры

hDevice

Дескриптор устройства отображения (графический контекст).

Format

Значение типа DXGI_FORMAT, указывающее формат целевого объекта отрисовки, для который выполняется проверка.

SampleCount

Количество выборок, для которых извлекаются уровни качества.

Flags

Сочетание D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG значений , объединенных с помощью побитовой операции OR.

pNumQualityLevels

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

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

None

Remarks

Драйвер может использовать функцию обратного вызова pfnSetErrorCb , чтобы задать код ошибки. Драйвер может задать E_INVALIDARG , если формат в параметре Format не существует или параметр pNumQualityLevels имеет значение NULL.

Если устройство не поддерживает несколько выборок с числом выборок, указанным в параметре SampleCount , драйвер отображения пользовательского режима должен возвращать ноль в переменной, на которую указывает параметр pNumQualityLevels .

Когда драйвер возвращает 1 или более в переменной, на которую указывает pNumQualityLevels , драйвер указывает количество вариантов выборки для конкретного устройства, доступных с заданным числом выборок. Например, если драйвер возвращает значение 3, для создания ресурсов с заданным количеством выборок можно использовать уровни качества 0, 1 и 2. Изготовитель устройства определяет эти уровни качества, которые среда выполнения Microsoft Direct3D не может запрашивать. Однако разные уровни качества при фиксированном количестве выборок могут ссылаться на различные пространственные макеты расположений выборок или различные методы разрешения.

Если драйвер получает 1 в SampleCount, драйвер всегда возвращает 1 в переменной, на которую указывает pNumQualityLevels .

Если драйвер получает значение 0 или больше 32 в SampleCount, драйвер всегда возвращает значение 0 в переменной, на которую указывает pNumQualityLevels .

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 (WDDM 1.3)
Минимальная версия сервера Windows Server 2012 R2
Целевая платформа Персональный компьютер
Верхняя часть d3d10umddi.h (включая D3d10umddi.h)

См. также раздел

CheckMultisampleQualityLevels

D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG

DXGI_FORMAT

pfnSetErrorCb