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 |