Partilhar via


PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS função de retorno de chamada (d3d10umddi.h)

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS recupera o número de níveis de qualidade que o dispositivo dá suporte para o número especificado de amostras.

Sintaxe

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3dwddm13DdiCheckmultisamplequalitylevels;

void Pfnd3dwddm13DdiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE hDevice,
  DXGI_FORMAT Format,
  UINT SampleCount,
  UINT Flags,
  UINT *pNumQualityLevels
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

Format

Um valor do tipo DXGI_FORMAT que indica o formato de destino de renderização para o qual a verificação é executada.

SampleCount

O número de exemplos para os qual recuperar os níveis de qualidade.

Flags

Uma combinação de valores D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG combinados usando uma operação OR bit a bit.

pNumQualityLevels

Um ponteiro para uma variável que recebe o número de níveis de qualidade que o dispositivo dá suporte para o número especificado de amostras.

Valor de retorno

Nenhum

Observações

O driver pode usar a função de retorno de chamada pfnSetErrorCb para definir um código de erro. O driver pode definir E_INVALIDARG se o formato no parâmetro Format não existir ou o parâmetro pNumQualityLevels for NULL.

Se o dispositivo não der suporte a várias amostras com o número de exemplos especificado no parâmetro SampleCount, o driver de exibição do modo de usuário deverá retornar zero na variável à qual o parâmetro pNumQualityLevels aponta.

Quando o driver retorna 1 ou mais na variável à qual pNumQualityLevels aponta, o driver indica o número de variações de amostragem específicas do dispositivo que estão disponíveis com a contagem de exemplo fornecida. Por exemplo, se o driver retornar 3, os níveis de qualidade 0, 1 e 2 poderão ser usados para criar recursos com a contagem de exemplo fornecida. O fabricante do dispositivo define esses níveis de qualidade, que o runtime do Microsoft Direct3D não pode consultar. No entanto, diferentes níveis de qualidade em uma contagem de exemplo fixa podem se referir a layouts espaciais diferentes dos locais de exemplo ou métodos diferentes de resolução.

Se o driver receber 1 em SampleCount, o driver sempre retornará 1 na variável à qual pNumQualityLevels aponta.

Se o driver receber 0 ou maior que 32 em SampleCount, o driver sempre retornará 0 na variável à qual pNumQualityLevels aponta.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8.1 (WDDM 1.3)
servidor com suporte mínimo Windows Server 2012 R2
da Plataforma de Destino Área de trabalho
cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Consulte também

CheckMultisampleQualityLevels

D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG

DXGI_FORMAT

pfnSetErrorCb