Compartir a través de


PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS función de devolución de llamada (d3d10umddi.h)

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS recupera el número de niveles de calidad que admite el dispositivo para el número especificado de muestras.

Sintaxis

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3dwddm13DdiCheckmultisamplequalitylevels;

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

Parámetros

hDevice

Identificador del dispositivo de visualización (contexto de gráficos).

Format

Valor de tipo DXGI_FORMAT que indica el formato de destino de representación para el que se realiza la comprobación.

SampleCount

Número de muestras para las que recuperar los niveles de calidad.

Flags

Combinación de D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG valores que se combinan mediante una operación OR bit a bit.

pNumQualityLevels

Puntero a una variable que recibe el número de niveles de calidad que admite el dispositivo para el número especificado de muestras.

Valor devuelto

None

Observaciones

El controlador puede usar la función de devolución de llamada pfnSetErrorCb para establecer un código de error. El controlador puede establecer E_INVALIDARG si el formato del parámetro Format no existe o el parámetro pNumQualityLevels es NULL.

Si el dispositivo no admite varios muestreos con el número de muestras especificadas en el parámetro SampleCount , el controlador de visualización en modo de usuario debe devolver cero en la variable a la que apunta el parámetro pNumQualityLevels .

Cuando el controlador devuelve 1 o más en la variable a la que apunta pNumQualityLevels , el controlador indica el número de variaciones de muestreo específicas del dispositivo que están disponibles con el recuento de muestras especificado. Por ejemplo, si el controlador devuelve 3, los niveles de calidad 0, 1 y 2 se pueden usar para crear recursos con el recuento de muestras especificado. El fabricante del dispositivo define estos niveles de calidad, que el tiempo de ejecución de Microsoft Direct3D no puede consultar. Sin embargo, diferentes niveles de calidad en un recuento fijo de muestras pueden hacer referencia a diferentes diseños espaciales de las ubicaciones de ejemplo o a diferentes métodos de resolución.

Si el controlador recibe 1 en SampleCount, el controlador siempre devuelve 1 en la variable a la que apunta pNumQualityLevels .

Si el controlador recibe 0 o mayor que 32 en SampleCount, el controlador siempre devuelve 0 en la variable a la que apunta pNumQualityLevels .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 (WDDM 1.3)
Servidor mínimo compatible Windows Server 2012 R2
Plataforma de destino Escritorio
Encabezado d3d10umddi.h (incluya D3d10umddi.h)

Consulte también

CheckMultisampleQualityLevels

D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG

DXGI_FORMAT

pfnSetErrorCb