Syntaxe
Paramètres
pExportNameType : LPCWSTR Le point d’entrée du nuanceur dans l’objet d’état pour lequel récupérer la taille de la pile. Pour les groupes d’impacts, un nuanceur individuel au sein du groupe d’impacts doit être spécifié à l’aide de la syntaxe : hitGroupName::shaderType Où hitGroupName est le nom du point d’entrée du groupe d’impacts et shaderType est l’une des valeurs suivantes :
- intersection
- anyhit
- closesthit
Valeur de retour
Type : UINT64 Quantité de mémoire de pile, en octets, requise 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’impacts, 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 erronées ne se perdent pas 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 doit être appelée uniquement si l’application souhaite configurer la taille de la pile en appelant SetPipelineStackSize, plutôt que de se fier à la taille de pile par défaut prudente. Cette méthode est valide uniquement pour les nuanceurs de génération de rayons, les groupes d’impacts, les nuanceurs d’échec 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’impacts, la taille de la pile doit être interrogée pour les nuanceurs individuels qui les composent (nuanceurs d’intersection, nuanceurs any hit, nuanceurs closest hit), car chacun a probablement une exigence de taille de pile différente. La taille de la pile ne peut pas être interrogée directement sur ces nuanceurs individuels, car la façon dont ils sont compilés peut être influencée par le groupe d’impacts global qui les contient. Le paramètre pExportName comprend une syntaxe permettant d’identifier les nuanceurs individuels au sein d’un groupe d’impacts. 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