DD_MULTISAMPLEQUALITYLEVELSDATA 结构 (d3dhal.h)

项目
02/26/2024

仅限 DirectX 9.0 及更高版本。

DD_MULTISAMPLEQUALITYLEVELSDATA是DD_GETDRIVERINFODATA的 lpvData 字段指向的数据结构，用于类型为 D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS 的DD_GETDRIVERINFO2DATA查询。

语法

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

成员

gdi2

指定包含 GetDriverInfo2 数据的DD_GETDRIVERINFO2DATA结构。

Format

使用 D3DFORMAT 枚举中的值来指定多采样呈现目标的表面格式。

bFlip

指示分辨率的类型。对于翻转样式分辨率，设置为 TRUE (1) ;对于 blt 样式分辨率，设置为 FALSE (0) 。

MSType

使用 D3DMULTISAMPLE_TYPE 枚举中的值来指定全场景多重采样的级别。如果显示设备支持可掩码多重采样 (多样本呈现目标格式的多个样本加上抗锯齿支持) ，则设备的驱动程序必须为D3DMULTISAMPLE_NONMASKABLE (1) 枚举值提供质量级别数。

QualityLevels

接收驱动程序支持的给定呈现目标格式的多样本质量级别的数量。

注解

驱动程序将 1 到 8 的整数分配给 QualityLevels 成员。如果驱动程序失败，则忽略此D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS查询，或返回一个范围之外的值，但否则会报告它支持多重采样，则运行时将确定质量级别数为 1。

当运行时调用驱动程序的 DdCanCreateSurface、DdCreateSurface 或 D3dCreateSurfaceEx 函数来创建图面时，运行时将多样本质量级别的数量编码为三位， (DDSCAPS3_MULTISAMPLE_QUALITY_MASK掩码) DDSCAPS2结构的 dwCaps3 成员。

有关D3DFORMAT和D3DMULTISAMPLE_TYPE的详细信息，请参阅 DirectX SDK 文档。