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