DD_MULTISAMPLEQUALITYLEVELSDATA結構（d3dhal.h）

發行項
02/06/2025

僅限 DirectX 9.0 和更新版本。

DD_MULTISAMPLEQUALITYLEVELSDATA是具有類型D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS之DD_GETDRIVERINFO2DATA查詢 DD_GETDRIVERINFODATAlpvData 字段所指向的數據結構。

語法

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

成員

gdi2

指定 DD_GETDRIVERINFO2DATA 結構，其中包含 GetDriverInfo2 數據。

Format

使用來自D3DFORMAT列舉的值來指定多重取樣轉譯目標的介面格式。

bFlip

表示解析度的類型。設定為 TRUE （1）以用於翻轉樣式的解析度，並將設為 FALSE （0）進行 blt 樣式解析度。

MSType

使用來自 D3DMULTISAMPLE_TYPE 列舉的值來指定全場景多重取樣層級。如果顯示裝置支援可遮罩的多重取樣（多個樣本的多重取樣轉譯目標格式加上反鋸齒支援），裝置的驅動程式必須提供D3DMULTISAMPLE_NONMASKABLE （1）列舉值的品質等級數目。

QualityLevels

接收驅動程式針對指定轉譯目標格式支援的多重樣本質量等級數目。

言論

驅動程式會將 1 到 8 的整數指派給 QualityLevels 成員。如果驅動程式失敗、忽略此D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS查詢，或傳回超出範圍的值，否則會報告它支援多重取樣，則運行時間會判斷品質層級的數目為 1。

當執行時間呼叫驅動程式的 DdCanCreateSurface、DdCreateSurface或 D3dCreateSurfaceEx 函式來建立介面時，運行時間會將多個樣本品質層級的數目編碼為 dwCaps3DDSCAPS2 結構成員的三個位（DDSCAPS3_MULTISAMPLE_QUALITY_MASK遮罩）。

如需D3DFORMAT和D3DMULTISAMPLE_TYPE的詳細資訊，請參閱 DirectX SDK 檔。