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

  • Статья

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

Синтаксис

PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3d10ddiCheckmultisamplequalitylevels;

void Pfnd3d10ddiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE unnamedParam1,
  DXGI_FORMAT unnamedParam2,
  UINT unnamedParam3,
  UINT *unnamedParam4
)
{...}

Параметры

unnamedParam1

hDevice [in]

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

unnamedParam2

Формат [in]

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

unnamedParam3

SampleCount [in]

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

unnamedParam4

pNumQualityLevels [out]

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

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

None

Remarks

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

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

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

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

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть d3d10umddi.h (включая D3d10umddi.h)

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

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb