estructura DD_MULTISAMPLEQUALITYLEVELSDATA (d3dhal.h)

Artículo
02/26/2024

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 DD_GETDRIVERINFO2DATA consultas 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 muestra múltiple.

bFlip

Indica el tipo de resolución. Establézcalo en TRUE (1) para la resolución de estilo invertida 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 pantalla admite el muestreo múltiple enmascarable (más de una muestra para un formato render-target de varias muestras más compatibilidad con antialias), el controlador para el 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.

Comentarios

El controlador asigna un entero de 1 a 8 al miembro 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 a las funciones DdCanCreateSurface, DdCreateSurface o D3dCreateSurfaceEx de un controlador 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 miembro dwCaps3 de una estructura DDSCAPS2 .

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