Partilhar via


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

A função CheckMultisampleQualityLevels recupera o número de níveis de qualidade que o dispositivo dá suporte para o número especificado de amostras.

Sintaxe

PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3d10ddiCheckmultisamplequalitylevels;

void Pfnd3d10ddiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE unnamedParam1,
  DXGI_FORMAT unnamedParam2,
  UINT unnamedParam3,
  UINT *unnamedParam4
)
{...}

Parâmetros

unnamedParam1

hDevice [in]

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

unnamedParam2

Formatar [in]

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

unnamedParam3

SampleCount [in]

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

unnamedParam4

pNumQualityLevels [out]

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 0 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 Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino Área de trabalho
cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Consulte também

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb