PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS fonction de rappel (d3d10umddi.h)

  • Article

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS récupère le nombre de niveaux de qualité pris en charge par l’appareil pour le nombre d’échantillons spécifié.

Syntaxe

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3dwddm13DdiCheckmultisamplequalitylevels;

void Pfnd3dwddm13DdiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE hDevice,
  DXGI_FORMAT Format,
  UINT SampleCount,
  UINT Flags,
  UINT *pNumQualityLevels
)
{...}

Paramètres

hDevice

Handle pour le périphérique d’affichage (contexte graphique).

Format

Valeur de type DXGI_FORMAT qui indique le format de cible de rendu pour lequel le case activée est effectué.

SampleCount

Nombre d’échantillons dont les niveaux de qualité doivent être récupérés.

Flags

Combinaison de valeurs D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG qui sont combinées à l’aide d’une opération OR au niveau du bit.

pNumQualityLevels

Pointeur vers une variable qui reçoit le nombre de niveaux de qualité pris en charge par l’appareil pour le nombre d’exemples spécifié.

Valeur de retour

None

Remarques

Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur. Le pilote peut définir E_INVALIDARG si le format dans le paramètre Format n’existe pas ou si le paramètre pNumQualityLevels a la valeur NULL.

Si l’appareil ne prend pas en charge plusieurs échantillonnages avec le nombre d’échantillons spécifié dans le paramètre SampleCount , le pilote d’affichage en mode utilisateur doit retourner zéro dans la variable vers laquelle pointe le paramètre pNumQualityLevels .

Lorsque le pilote retourne 1 ou plus dans la variable vers laquelle pNumQualityLevels pointe, le pilote indique le nombre de variantes d’échantillonnage spécifiques au périphérique disponibles avec le nombre d’échantillons donné. Par exemple, si le pilote retourne 3, les niveaux de qualité 0, 1 et 2 peuvent être utilisés pour créer des ressources avec le nombre d’échantillons donné. Le fabricant de l’appareil définit ces niveaux de qualité, que le runtime Microsoft Direct3D ne peut pas interroger. Toutefois, différents niveaux de qualité à un nombre fixe d’échantillons peuvent faire référence à différentes dispositions spatiales des emplacements d’échantillons ou à différentes méthodes de résolution.

Si le pilote reçoit 1 dans SampleCount, le pilote retourne toujours 1 dans la variable vers laquelle pNumQualityLevels pointe.

Si le pilote reçoit 0 ou supérieur à 32 dans SampleCount, le pilote retourne toujours 0 dans la variable vers laquelle pNumQualityLevels pointe.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1 (WDDM 1.3)
Serveur minimal pris en charge Windows Server 2012 R2
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3d10umddi.h (incluez D3d10umddi.h)

Voir aussi

CheckMultisampleQualityLevels

D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG

DXGI_FORMAT

pfnSetErrorCb