Метод ID3D11Device::CheckMultisampleQualityLevels (d3d11.h)

  • Статья

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

Синтаксис

HRESULT CheckMultisampleQualityLevels(
  [in]  DXGI_FORMAT Format,
  [in]  UINT        SampleCount,
  [out] UINT        *pNumQualityLevels
);

Параметры

[in] Format

Тип: DXGI_FORMAT

Формат текстуры. См . DXGI_FORMAT.

[in] SampleCount

Тип: UINT

Количество выборок во время множественной выборки.

[out] pNumQualityLevels

Тип: UINT*

Количество уровней качества, поддерживаемых адаптером. См. Примечания.

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

Тип: HRESULT

Этот метод возвращает один из следующих кодов возврата Direct3D 11.

Комментарии

При множественной выборке текстуры количество уровней качества, доступных для адаптера, зависит от используемого формата текстуры и количества запрошенных образцов. Максимальное количество уровней качества определяется D3D11_MAX_MULTISAMPLE_SAMPLE_COUNT в D3D11.h. Если этот метод возвращает значение 0 (S_OK), а выходной параметр pNumQualityLevels получает положительное значение, то для устройства поддерживается сочетание формата и количества примеров. Если сочетание не поддерживается, этот метод возвращает код ошибки HRESULT (т. е. отрицательное целое число) или задает pNumQualityLevels выходной параметр равным нулю или и тому, и другому.

Кроме того, определение уровня качества определяется каждым поставщиком оборудования; Однако Direct3D не предоставляет возможности для обнаружения этих сведений.

Обратите внимание, что FEATURE_LEVEL_10_1 устройства должны поддерживать 4x MSAA для всех целевых объектов отрисовки, за исключением R32G32B32A32 и R32G32B32. FEATURE_LEVEL_11_0 устройства должны поддерживать 4x MSAA для всех целевых форматов отрисовки и 8x MSAA для всех целевых форматов отрисовки, кроме форматов R32G32B32A32.

Требования

Требование Значение
Целевая платформа Windows
Header d3d11.h
Библиотека D3D11.lib

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

ID3D11Device