Sintaxis
Parámetros
pExportNameTipo: LPCWSTR El punto de entrada del sombreador en el objeto de estado para el que se recupera el tamaño de pila. Para los grupos de aciertos, se debe especificar un sombreador individual dentro del grupo de aciertos mediante la sintaxis: hitGroupName::shaderType Donde hitGroupName es el nombre del punto de entrada del grupo de aciertos y shaderType es uno de los siguientes:
- intersection
- anyhit
- closesthit
Valor devuelto
Tipo: UINT64 Cantidad de memoria de pila, en bytes, necesaria para invocar el sombreador. Si el sombreador no está totalmente resuelto en el objeto de estado, o el sombreador es desconocido o de un tipo para el que el tamaño de pila no es relevante, como un grupo de aciertos, el valor devuelto es 0xffffffff. El valor de 32 bits 0xffffffff se usa para el valor devuelto UINT64 con el fin de garantizar que los valores devueltos incorrectos no se pierdan al sumarse con otros valores como parte del cálculo del tamaño total de la pila de la canalización.Comentarios
Solo es necesario llamar a este método si la aplicación quiere configurar el tamaño de pila llamando a SetPipelineStackSize, en lugar de basarse en el tamaño de pila predeterminado conservador. Este método solo es válido para sombreadores de generación de rayos, grupos de aciertos, sombreadores de error y sombreadores invocables. Incluso los sombreadores de generación de rayos pueden devolver un valor distinto de cero a pesar de estar en la parte inferior de la pila. Para los grupos de aciertos, el tamaño de pila debe consultarse para los sombreadores individuales que los componen (sombreadores de intersección, sombreadores de cualquier acierto, sombreadores de acierto más cercano), ya que es probable que cada uno tenga un requisito de tamaño de pila distinto. El tamaño de pila no se puede consultar directamente en estos sombreadores individuales, ya que la forma en que se compilan puede verse influida por el grupo de aciertos general que los contiene. El parámetro pExportName incluye sintaxis para identificar sombreadores individuales dentro de un grupo de aciertos. Se puede llamar a esta API en objetos de estado de colección o en objetos de estado de canalización de trazado de rayos.Requisitos
Encabezado: d3d12_xs.hBiblioteca: d3d12_xs.lib
Plataformas compatibles: consolas XBOX Series