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

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1 (WDDM 1.3)
Servidor mínimo com suporte	Windows Server 2012 R2
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3d10umddi.h (inclua D3d10umddi.h)

Confira também

CheckMultisampleQualityLevels

D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG

DXGI_FORMAT

pfnSetErrorCb