ID3D11Device ::CheckMultisampleQualityLevels, méthode (d3d11.h)

  • Article

Obtenez le nombre de niveaux de qualité disponibles lors de l’échantillonnage multiple.

Syntaxe

HRESULT CheckMultisampleQualityLevels(
  [in]  DXGI_FORMAT Format,
  [in]  UINT        SampleCount,
  [out] UINT        *pNumQualityLevels
);

Paramètres

[in] Format

Type : DXGI_FORMAT

Format de texture. Voir DXGI_FORMAT.

[in] SampleCount

Type : UINT

Nombre d’échantillons lors de l’échantillonnage multiple.

[out] pNumQualityLevels

Type : UINT*

Nombre de niveaux de qualité pris en charge par l’adaptateur. Consultez Remarques.

Valeur retournée

Type : HRESULT

Cette méthode retourne l’un des codes de retour Direct3D 11 suivants.

Remarques

Lors de l’échantillonnage multiple d’une texture, le nombre de niveaux de qualité disponibles pour un adaptateur dépend du format de texture utilisé et du nombre d’échantillons demandés. Le nombre maximal de niveaux de qualité est défini par D3D11_MAX_MULTISAMPLE_SAMPLE_COUNT dans D3D11.h. Si cette méthode retourne 0 (S_OK) et que le paramètre pNumQualityLevels de sortie reçoit une valeur positive, la combinaison de format et de nombre d’échantillons est prise en charge pour l’appareil. Lorsque la combinaison n’est pas prise en charge, cette méthode retourne un code HRESULT d’échec (c’est-à-dire un entier négatif) ou définit pNumQualityLevels le paramètre de sortie sur zéro, ou les deux.

En outre, la définition d’un niveau de qualité est laissée à chaque fournisseur de matériel à définir ; toutefois, aucune fonctionnalité n’est fournie par Direct3D pour faciliter la découverte de ces informations.

Notez que FEATURE_LEVEL_10_1 appareils doivent prendre en charge 4x MSAA pour toutes les cibles de rendu, à l’exception des R32G32B32A32 et des R32G32B32. FEATURE_LEVEL_11_0 appareils doivent prendre en charge 4x MSAA pour tous les formats cibles de rendu, et 8x MSAA pour tous les formats cibles de rendu, à l’exception des formats R32G32B32A32.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d11.h
Bibliothèque D3D11.lib

Voir aussi

ID3D11Device