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 |