DD_MULTISAMPLEQUALITYLEVELSDATA Struktur (d3dhal.h)

Artikel
02/06/2025

Nur DirectX 9.0 und höhere Versionen.

DD_MULTISAMPLEQUALITYLEVELSDATA ist die Datenstruktur, auf die durch das lpvData Feld DD_GETDRIVERINFODATA für DD_GETDRIVERINFO2DATA Abfragen mit dem Typ D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS verwiesen wird.

Syntax

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

Angehörige

gdi2

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

Format

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

bFlip

Gibt den Typ der Auflösung an. Legen Sie den Wert auf "TRUE" fest, (1) für die Auflösung der Flip-Formatvorlage und auf FALSE- (0) für die Auflösung der Blt-Formatvorlage.

MSType

Verwendet einen Wert aus der D3DMULTISAMPLE_TYPE-Aufzählung, um die Ebene des Multisamplings in voller Szene anzugeben. Wenn das Anzeigegerät maskierbare Multisampling unterstützt (mehr als ein Beispiel für ein Renderzielformat mit mehreren Beispielen plus Antialias-Unterstützung), muss der Treiber für das Gerät die Anzahl der Qualitätsstufen für den aufgezählten D3DMULTISAMPLE_NONMASKABLE (1) bereitstellen.

QualityLevels

Empfängt die Anzahl von Mehreren Beispielqualitätsstufen, die der Treiber für das angegebene Renderzielformat unterstützt.

Bemerkungen

Der Treiber weist dem QualityLevels Member eine ganze Zahl von 1 bis 8 zu. Wenn der Treiber fehlschlägt, ignoriert diese D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS Abfrage oder gibt einen Wert zurück, der außerhalb des Bereichs liegt. Andernfalls wird jedoch gemeldet, dass er Multisampling unterstützt, dann bestimmt die Laufzeit, dass die Anzahl der Qualitätsstufen 1 ist.

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

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