Поделиться через


функция обратного вызова 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

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

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

Никакой

Замечания

Драйвер может использовать функцию обратного вызова 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 (include D3d10umddi.h)

См. также

CheckMultisampleQualityLevels

D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG

DXGI_FORMAT

pfnSetErrorCb