DD_MULTISAMPLEQUALITYLEVELSDATA 構造体 (d3dhal.h)

[アーティクル]
02/23/2024

DirectX 9.0 以降のバージョンのみ。

DD_MULTISAMPLEQUALITYLEVELSDATAは、型がD3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELSされたDD_GETDRIVERINFO2DATAクエリのDD_GETDRIVERINFODATAの lpvData フィールドが指すデータ構造です。

構文

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 関数を呼び出してサーフェスを作成すると、ランタイムは、複数サンプル品質レベルの数を、DDSCAPS2構造体の dwCaps3 メンバーの 3 ビット (DDSCAPS3_MULTISAMPLE_QUALITY_MASK マスク) にエンコードします。

D3DFORMATとD3DMULTISAMPLE_TYPEの詳細については、DirectX SDK のドキュメントを参照してください。