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

Obtenha o número de níveis de qualidade disponíveis durante a multiamostragem.

Sintaxe

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

Parâmetros

[in] Format

Tipo: DXGI_FORMAT

O formato de textura. Consulte DXGI_FORMAT.

[in] SampleCount

Tipo: UINT

O número de amostras durante a multiamostragem.

[out] pNumQualityLevels

Tipo: UINT*

Número de níveis de qualidade compatíveis com o adaptador. Veja os Comentários.

Retornar valor

Tipo: HRESULT

Esse método retorna um dos seguintes códigos de retorno do Direct3D 11.

Comentários

Ao multiplicar uma textura, o número de níveis de qualidade disponíveis para um adaptador depende do formato de textura usado e do número de amostras solicitadas. O número máximo de níveis de qualidade é definido por D3D11_MAX_MULTISAMPLE_SAMPLE_COUNT em D3D11.h. Se esse método retornar 0 (S_OK) e o parâmetro pNumQualityLevels de saída receber um valor positivo, a combinação de contagem de exemplo e formato terá suporte para o dispositivo. Quando não há suporte para a combinação, esse método retorna um código HRESULT de falha (ou seja, um inteiro negativo) ou define pNumQualityLevels o parâmetro de saída como zero ou ambos.

Além disso, a definição de um nível de qualidade é deixada para cada fornecedor de hardware definir; no entanto, nenhuma instalação é fornecida pelo Direct3D para ajudar a descobrir essas informações.

Observe que FEATURE_LEVEL_10_1 dispositivos são necessários para dar suporte a MSAA 4x para todos os destinos de renderização, exceto R32G32B32A32 e R32G32B32. FEATURE_LEVEL_11_0 dispositivos são necessários para dar suporte a MSAA 4x para todos os formatos de destino de renderização e MSAA 8x para todos os formatos de destino de renderização, exceto R32G32B32A32 formatos.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	d3d11.h
Biblioteca	D3D11.lib

Confira também

ID3D11Device