PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS fonction de rappel (d3d10umddi.h)
La fonction CheckMultisampleQualityLevels récupère le nombre de niveaux de qualité pris en charge par l’appareil pour le nombre spécifié d’échantillons.
Syntaxe
PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3d10ddiCheckmultisamplequalitylevels;
void Pfnd3d10ddiCheckmultisamplequalitylevels(
D3D10DDI_HDEVICE unnamedParam1,
DXGI_FORMAT unnamedParam2,
UINT unnamedParam3,
UINT *unnamedParam4
)
{...}
Paramètres
unnamedParam1
hDevice [in]
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
Format [in]
Valeur DXGI_FORMAT typée qui indique le format de la cible de rendu pour lequel la vérification est effectuée.
unnamedParam3
SampleCount [in]
Nombre d’échantillons pour utilisant les niveaux de qualité.
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 spécifié d’échantillons.
Valeur de retour
Aucun
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és dans le paramètre SampleCount, le pilote d’affichage en mode utilisateur doit retourner 0 dans la variable à 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 à l’appareil 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é au nombre d’échantillons fixes peuvent faire référence à différentes dispositions spatiales des emplacements de l’exemple ou à différentes méthodes de résolution.
Si le pilote reçoit 1 dans SampleCount, le pilote retourne toujours 1 dans la variable à laquelle pNumQualityLevels pointe.
Si le pilote reçoit 0 ou supérieur à 32 dans SampleCount, le pilote retourne toujours 0 dans la variable à laquelle pNumQualityLevels pointe.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | d3d10umddi.h (include D3d10umddi.h) |