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

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS recupera o número de níveis de qualidade compatíveis com o dispositivo 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 render-target para o qual o marcar é executado.

SampleCount

O número de exemplos para os quais 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.

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 oferecer 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 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

Confira também

CheckMultisampleQualityLevels

D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG

DXGI_FORMAT

pfnSetErrorCb