Método ID3D11Device::CheckMultisampleQualityLevels (d3d11.h)

Obtenga el número de niveles de calidad disponibles durante el muestreo múltiple.

Sintaxis

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

Parámetros

[in] Format

Tipo: DXGI_FORMAT

Formato de textura. Consulte DXGI_FORMAT.

[in] SampleCount

Tipo: UINT

Número de muestras durante el muestreo múltiple.

[out] pNumQualityLevels

Tipo: UINT*

Número de niveles de calidad admitidos por el adaptador. Vea Comentarios.

Valor devuelto

Tipo: HRESULT

Este método devuelve uno de los siguientes códigos de retorno de Direct3D 11.

Comentarios

Cuando se realiza un muestreo múltiple de una textura, el número de niveles de calidad disponibles para un adaptador depende del formato de textura usado y del número de muestras solicitadas. El número máximo de niveles de calidad se define mediante D3D11_MAX_MULTISAMPLE_SAMPLE_COUNT en D3D11.h. Si este método devuelve 0 (S_OK) y el parámetro pNumQualityLevels de salida recibe un valor positivo, se admite la combinación de formato y recuento de muestras para el dispositivo. Cuando no se admite la combinación, este método devuelve un código HRESULT de error (es decir, un entero negativo) o establece pNumQualityLevels el parámetro de salida en cero o ambos.

Además, la definición de un nivel de calidad queda a cada proveedor de hardware que defina; sin embargo, Direct3D no proporciona ninguna instalación para ayudar a descubrir esta información.

Tenga en cuenta que FEATURE_LEVEL_10_1 dispositivos son necesarios para admitir 4x MSAA para todos los destinos de representación, excepto R32G32B32A32 y R32G32B32. FEATURE_LEVEL_11_0 dispositivos son necesarios para admitir 4x MSAA para todos los formatos de destino de representación y 8x MSAA para todos los formatos de destino de representación, excepto R32G32B32A32 formatos.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d11.h
Library	D3D11.lib

Consulte también

ID3D11Device