PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS fonction de rappel (d3d10umddi.h)

  • Article

La fonction CheckMultisampleQualityLevels récupère le nombre de niveaux de qualité pris en charge par l’appareil pour le nombre d’exemples spécifié.

Syntaxe

PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3d10ddiCheckmultisamplequalitylevels;

void Pfnd3d10ddiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE unnamedParam1,
  DXGI_FORMAT unnamedParam2,
  UINT unnamedParam3,
  UINT *unnamedParam4
)
{...}

Paramètres

unnamedParam1

hDevice [in]

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

unnamedParam2

Format [in]

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

unnamedParam3

SampleCount [in]

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

unnamedParam4

pNumQualityLevels [out]

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 est 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 0 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 Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3d10umddi.h (incluez D3d10umddi.h)

Voir aussi

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb