Sintaxe
Parâmetros
pExportNameTipo: LPCWSTR O ponto de entrada do sombreador no objeto de estado para o qual recuperar o tamanho da pilha. Para grupos de acertos, um sombreador individual dentro do grupo de acertos deve ser especificado usando a sintaxe: hitGroupName::shaderType Em que hitGroupName é o nome do ponto de entrada do grupo de acertos e shaderType é um dos seguintes:
- intersection
- anyhit
- closesthit
Valor retornado
Tipo: UINT64 Quantidade de memória de pilha, em bytes, necessária para invocar o sombreador. Se o sombreador não estiver totalmente resolvido no objeto de estado, ou se o sombreador for desconhecido ou de um tipo para o qual o tamanho da pilha não é relevante, como um grupo de acertos, o valor retornado será 0xffffffff. O valor de 32 bits 0xffffffff é usado para o valor retornado UINT64 para garantir que valores retornados inválidos não se percam quando somados a outros valores como parte do cálculo do tamanho geral da pilha do pipeline.Comentários
Este método só precisa ser chamado se o aplicativo quiser configurar o tamanho da pilha chamando SetPipelineStackSize, em vez de depender do tamanho de pilha padrão conservador. Este método só é válido para sombreadores de geração de raios, grupos de acertos, sombreadores de erro (miss) e sombreadores chamáveis. Até mesmo sombreadores de geração de raios podem retornar um valor diferente de zero, apesar de estarem na base da pilha. Para grupos de acertos, o tamanho da pilha deve ser consultado para os sombreadores individuais que o compõem (sombreadores de interseção, sombreadores de qualquer acerto, sombreadores de acerto mais próximo), pois cada um provavelmente tem um requisito de tamanho de pilha diferente. O tamanho da pilha não pode ser consultado diretamente nesses sombreadores individuais, pois a forma como são compilados pode ser influenciada pelo grupo de acertos geral que os contém. O parâmetro pExportName inclui sintaxe para identificar sombreadores individuais dentro de um grupo de acertos. Esta API pode ser chamada em objetos de estado de coleção ou em objetos de estado de pipeline de traçado de raios.Requisitos
Cabeçalho: d3d12_xs.hBiblioteca: d3d12_xs.lib
Plataformas com suporte: consoles XBOX Series