Syntaxe
Paramètres
pExportNameType : LPCWSTR Point d’entrée du nuanceur dans l’objet d’état pour lequel récupérer la taille de pile. Pour les groupes d’impact (hit groups), un nuanceur individuel du groupe d’impact doit être spécifié à l’aide de la syntaxe : hitGroupName::shaderType Où hitGroupName est le nom du point d’entrée du groupe d’impact et shaderType est l’une des valeurs suivantes :
- intersection
- anyhit
- closesthit
Valeur de retour
Type : UINT64 Quantité de mémoire de pile, en octets, nécessaire pour appeler le nuanceur. Si le nuanceur n’est pas entièrement résolu dans l’objet d’état, ou si le nuanceur est inconnu ou d’un type pour lequel une taille de pile n’est pas pertinente, comme un groupe d’impact, la valeur de retour est 0xffffffff. La valeur 32 bits 0xffffffff est utilisée pour la valeur de retour UINT64 afin de garantir que les valeurs de retour incorrectes ne soient pas perdues lorsqu’elles sont additionnées à d’autres valeurs dans le cadre du calcul de la taille globale de la pile du pipeline.Remarques
Cette méthode ne doit être appelée que si l’application souhaite configurer la taille de la pile en appelant SetPipelineStackSize, plutôt que de s’appuyer sur la taille de pile par défaut prudente. Cette méthode n’est valide que pour les nuanceurs de génération de rayons, les groupes d’impact, les nuanceurs d’échec (miss shaders) et les nuanceurs appelables. Même les nuanceurs de génération de rayons peuvent retourner une valeur non nulle bien qu’ils se trouvent au bas de la pile. Pour les groupes d’impact, la taille de pile doit être interrogée pour chacun des nuanceurs qui les composent (nuanceurs d’intersection, nuanceurs any hit, nuanceurs closest hit), car chacun a probablement des besoins de taille de pile différents. La taille de pile ne peut pas être interrogée directement sur ces nuanceurs individuels, car leur mode de compilation peut être influencé par le groupe d’impact global qui les contient. Le paramètre pExportName comprend une syntaxe permettant d’identifier les nuanceurs individuels au sein d’un groupe d’impact. Cette API peut être appelée sur des objets d’état de collection ou sur des objets d’état de pipeline de lancer de rayons.Configuration requise
En-tête : d3d12_xs.hBibliothèque : d3d12_xs.lib
Plateformes prises en charge : consoles XBOX Series