Syntaxe
Paramètres
Mask [in]Type : UINT Masque qui spécifie les vues activées ou désactivées. Si le bit i, en partant du bit de poids faible, est défini, l’instance de vue i est activée.
Valeur renvoyée
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. La tentative de création d’un PSO qui déclare le masquage d’instances de vue échoue sur les cartes 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 n’est 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 à un travail inutile. Les bundles n’héritent pas du masque d’instances de vue de leur appelant ; ils utilisent la valeur 0 par défaut. En effet, la valeur du masque doit être connue lors de l’enregistrement du bundle si elle affecte la façon dont une implémentation enregistre les dessins. Toutefois, le masque d’instances de vue défini par un bundle persiste pour l’appelant une fois le bundle terminé. Cette sémantique d’héritage est similaire à 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 baisse de performances par rapport aux PSO qui ne déclarent pas du tout le masquage d’instances de vue, mais cette baisse est généralement compensée par le gain de performances obtenu 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