PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS fonction de rappel (d3d10umddi.h)
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) |