Compartilhar via


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

A função CheckMultisampleQualityLevels recupera o número de níveis de qualidade aos quais 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 de tipo DXGI_FORMAT que indica o formato render-target para o qual o marcar é executado.

unnamedParam3

SampleCount [in]

O número de exemplos para os quais 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 aos quais o dispositivo dá suporte para o número especificado de amostras.

Retornar valor

Nenhum

Comentários

O driver pode usar a função de retorno de chamada pfnSetErrorCb para definir um código de erro. O driver poderá 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 amostras especificado no parâmetro SampleCount , o driver de exibição do modo de usuário deverá retornar 0 na variável para a qual o parâmetro pNumQualityLevels aponta.

Quando o driver retorna 1 ou mais na variável para a 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 diferentes layouts espaciais dos locais de exemplo ou diferentes métodos de resolução.

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

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Confira também

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb