ID3D11Device2 ::CheckMultisampleQualityLevels1, méthode (d3d11_2.h)

Obtenez le nombre de niveaux de qualité disponibles pendant le multi-échantillonnage.

Syntaxe

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

Paramètres

[in] Format

Type : DXGI_FORMAT

Format de texture pendant le multi-échantillonnage.

[in] SampleCount

Type : UINT

Nombre d’exemples pendant le multi-échantillonnage.

[in] Flags

Type : UINT

Combinaison de valeurs D3D11_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAGS combinées à l’aide d’une opération OR au niveau du bit. Actuellement, seule D3D11_CHECK_MULTISAMPLE_QUALITY_LEVELS_TILED_RESOURCE est prise en charge.

[out] pNumQualityLevels

Type : UINT*

Pointeur vers une variable qui reçoit le nombre de niveaux de qualité pris en charge par l’adaptateur. Consultez la section Notes.

Valeur de retour

Type : HRESULT

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

Remarques

Lorsque vous multi-échantillonner une texture, le nombre de niveaux de qualité disponibles pour une carte dépend du format de texture que vous utilisez et du nombre d’exemples que vous demandez. 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, la combinaison de format et de nombre d’exemples n’est pas prise en charge pour l’adaptateur installé.

En outre, la définition d’un niveau de qualité appartient à chaque fournisseur de matériel de définir, mais direct3D ne fournit aucune fonctionnalité pour aider à découvrir ces informations.

Notez que les appareils FEATURE_LEVEL_10_1 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

Voir aussi

ID3D11Device2