DD_MULTISAMPLEQUALITYLEVELSDATA Struktur (d3dhal.h)

Artikel
02/23/2024

Nur DirectX 9.0 und höhere Versionen.

DD_MULTISAMPLEQUALITYLEVELSDATA ist die Datenstruktur, auf die das lpvData-Feld von DD_GETDRIVERINFODATA für DD_GETDRIVERINFO2DATA Abfragen mit dem Typ D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS verweist.

Syntax

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

Member

gdi2

Gibt eine DD_GETDRIVERINFO2DATA-Struktur an, die die GetDriverInfo2-Daten enthält.

Format

Verwendet einen Wert aus der D3DFORMAT-Enumeration, um das Oberflächenformat des Renderziels mit mehreren Stichproben anzugeben.

bFlip

Gibt den Auflösungstyp an. Legen Sie für die Auflösung im Flip-Stil auf TRUE (1) und für die Auflösung im Blt-Stil auf FALSE (0) fest.

MSType

Verwendet einen Wert aus der D3DMULTISAMPLE_TYPE-Enumeration, um die Ebene des Vollszenen-Multisamplings anzugeben. Wenn das Anzeigegerät maskierbares Multisampling unterstützt (mehr als ein Beispiel für ein Renderzielformat mit mehreren Stichproben plus Antialiasunterstützung), muss der Treiber für das Gerät die Anzahl von Qualitätsstufen für den D3DMULTISAMPLE_NONMASKABLE (1) enumerierten Wert angeben.

QualityLevels

Empfängt die Anzahl von Qualitätsstufen mit mehreren Stichproben, die der Treiber für das angegebene Renderzielformat unterstützt.

Hinweise

Der Treiber weist dem QualityLevels-Member eine ganze Zahl zwischen 1 und 8 zu. Wenn der Treiber fehlschlägt, diese D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS Abfrage ignoriert oder einen Wert zurückgibt, der außerhalb des Bereichs liegt, andernfalls aber meldet, dass er Multisampling unterstützt, bestimmt die Laufzeit, dass die Anzahl der Qualitätsebenen 1 ist.

Wenn die Laufzeit die Funktionen DdCanCreateSurface, DdCreateSurface oder D3dCreateSurfaceEx eines Treibers aufruft, um eine Oberfläche zu erstellen, codiert die Laufzeit die Anzahl der Qualitätsebenen mit mehreren Beispielen in drei Bits (die DDSCAPS3_MULTISAMPLE_QUALITY_MASK-Maske) des dwCaps3-Elements einer DDSCAPS2-Struktur .

Weitere Informationen zu D3DFORMAT und D3DMULTISAMPLE_TYPE finden Sie in der DirectX SDK-Dokumentation.