Syntaxe
Paramètres
Mask [in]Type : UINT Masque qui spécifie quelles vues sont activées ou désactivées. Si le bit i, à partir du bit le moins significatif, est défini, l’instance de vue i est activée.
Valeur de retour
Type : void Aucune.Remarques
Le masque d’instances de vue n’affecte que les PSO qui déclarent le masquage d’instances de vue en spécifiant l’indicateur D3D12_VIEW_INSTANCING_FLAG_ENABLE_VIEW_INSTANCE_MASKING lors de leur création. Toute tentative de création d’un PSO qui déclare le masquage d’instances de vue échouera sur les adaptateurs qui ne prennent pas en charge l’instanciation de vues. Le masque d’instances de vue a la valeur 0 par défaut, ce qui désactive toutes les vues. Cela oblige les applications qui déclarent le masquage d’instances de vue à choisir explicitement les vues à activer; sinon, rien ne sera rendu. Si le masque d’instances de vue activait toutes les vues par défaut, l’application pourrait oublier de désactiver les vues inutilisées, ce qui entraînerait une perte de performances due à du travail inutile. Les bundles n’héritent pas du masque d’instances de vue de leur appelant et ont plutôt la valeur 0 par défaut. En effet, la valeur du masque doit être connue lors de l’enregistrement du bundle si elle influe sur la façon dont une implémentation enregistre les dessins. Le masque d’instances de vue défini par un bundle persiste toutefois chez l’appelant une fois le bundle terminé. Cette sémantique d’héritage est semblable à celle des PSO. Aucun chemin de code de nuanceur dépendant de SV_ViewID n’est exécuté à quelque étape de nuanceur que ce soit pour les instances de vue masquées, et aucun découpage, traitement de fenêtre d’affichage ou rastérisation n’est effectué. Les implémentations qui inspectent le masque pendant le rendu peuvent subir une légère pénalité de performances par rapport aux PSO qui ne déclarent aucunement le masquage d’instances de vue, mais cette pénalité est généralement compensée par les gains de performances obtenus en ignorant le travail associé aux vues masquées. Selon la fréquence et la quantité de travail ignoré, les gains de performances peuvent être importants.Configuration requise
En-tête : d3d12_xs.h ou d3d12_x.hBibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One