structure DD_MULTISAMPLEQUALITYLEVELSDATA (d3dhal.h)

Article
02/06/2025

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 à plusieurs échantillons.

bFlip

Indique le type de résolution. Défini sur TRUE (1) pour la résolution de style flip 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 multisampling de scène complète. Si l’appareil d’affichage prend en charge l’échantillonnage multisampling masquable (plusieurs exemples pour un format cible de rendu multiple et la prise en charge des antialias), 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é à 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 plage, mais indique qu’elle prend en charge l’échantillonnage multiple, le runtime détermine que le nombre de niveaux de qualité est égal à 1.

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

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