estructura DD_MULTISAMPLEQUALITYLEVELSDATA (d3dhal.h)

Artículo
02/06/2025

DirectX 9.0 y versiones posteriores solo.

DD_MULTISAMPLEQUALITYLEVELSDATA es la estructura de datos a la que apunta el campo lpvData de DD_GETDRIVERINFODATA para las consultas de DD_GETDRIVERINFO2DATA con el tipo D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS.

Sintaxis

typedef struct _DD_MULTISAMPLEQUALITYLEVELSDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  D3DFORMAT             Format;
  BOOL                  bFlip : 1;
  D3DMULTISAMPLE_TYPE   MSType : 31;
  DWORD                 QualityLevels;
} DD_MULTISAMPLEQUALITYLEVELSDATA;

Miembros

gdi2

Especifica una estructura DD_GETDRIVERINFO2DATA que contiene los datos de GetDriverInfo2.

Format

Usa un valor de la enumeración D3DFORMAT para especificar el formato de superficie del destino de representación de varias muestras.

bFlip

Indica el tipo de resolución. Establézcalo en TRUE (1) para la resolución de estilo volteo y en FALSE (0) para la resolución de estilo blt.

MSType

Usa un valor de la enumeración D3DMULTISAMPLE_TYPE para especificar el nivel de muestreo múltiple de escena completa. Si el dispositivo de visualización admite el muestreo múltiple enmascarable (más de un ejemplo para un formato render-target de varias muestras más la compatibilidad con antialias), el controlador del dispositivo debe proporcionar el número de niveles de calidad para el valor enumerado de D3DMULTISAMPLE_NONMASKABLE (1).

QualityLevels

Recibe el número de niveles de calidad de varias muestras que admite el controlador para el formato de destino de representación especificado.

Observaciones

El controlador asigna un entero de 1 a 8 al miembro de QualityLevels. Si se produce un error en el controlador, omite esta consulta de D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS o devuelve un valor que está fuera del intervalo, pero, de lo contrario, informa de que admite el muestreo múltiple, el tiempo de ejecución determina que el número de niveles de calidad es 1.

Cuando el tiempo de ejecución llama al DdCanCreateSurface de un controlador, DdCreateSurface, o funciones D3dCreateSurfaceEx para crear una superficie, el tiempo de ejecución codifica el número de niveles de calidad de varias muestras en tres bits (la máscara DDSCAPS3_MULTISAMPLE_QUALITY_MASK) del dwCaps3 miembro de una estructura de DDSCAPS2.

Para obtener más información sobre D3DFORMAT y D3DMULTISAMPLE_TYPE, consulte la documentación del SDK de DirectX.