DD_MULTISAMPLEQUALITYLEVELSDATA structure (d3dhal.h)

Article
02/23/2024

DirectX 9.0 et versions ultérieures uniquement.

DD_MULTISAMPLEQUALITYLEVELSDATA est la structure de données pointée par le champ lpvData de DD_GETDRIVERINFODATA pour les requêtes DD_GETDRIVERINFO2DATA avec le type D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS.

Syntaxe

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

Membres

gdi2

Spécifie une structure DD_GETDRIVERINFO2DATA qui contient les données GetDriverInfo2 .

Format

Utilise une valeur de l’énumération D3DFORMAT pour spécifier le format de surface de la cible de rendu échantillonné à plusieurs échantillons.

bFlip

Indique le type de résolution. Définissez sur TRUE (1) pour la résolution de style inversé et sur FALSE (0) pour la résolution de style blt.

MSType

Utilise une valeur de l’énumération D3DMULTISAMPLE_TYPE pour spécifier le niveau d’échantillonnage multi-scène complet. Si le périphérique d’affichage prend en charge l’échantillonnage multiple masquable (plusieurs exemples pour un format cible de rendu à plusieurs exemples plus prise en charge des anticrénelies), le pilote de l’appareil doit fournir le nombre de niveaux de qualité pour la valeur énumérée D3DMULTISAMPLE_NONMASKABLE (1).

QualityLevels

Reçoit le nombre de niveaux de qualité de plusieurs échantillons pris en charge par le pilote pour le format de cible de rendu donné.

Remarques

Le pilote affecte un entier compris entre 1 et 8 au membre QualityLevels . Si le pilote échoue, ignore cette requête D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS ou retourne une valeur hors limites, mais indique sinon qu’il prend en charge l’échantillonnage multiple, le runtime détermine que le nombre de niveaux de qualité est égal à 1.

Lorsque le runtime appelle les fonctions DdCanCreateSurface, DdCreateSurface ou D3dCreateSurfaceEx d’un pilote pour créer une surface, le runtime encode le nombre de niveaux de qualité de plusieurs échantillons en trois bits (masque DDSCAPS3_MULTISAMPLE_QUALITY_MASK) du membre dwCaps3 d’une structure DDSCAPS2 .

Pour plus d’informations sur D3DFORMAT et D3DMULTISAMPLE_TYPE, consultez la documentation du Kit de développement logiciel (SDK) DirectX.