Skip to main content
Grava um relatório de estatísticas de LOD de PRT em um buffer de memória. O relatório contém informações sobre contagens de amostras de LOD de mip e clamping para recursos que foram marcados para rastreamento pelo hardware de LOD de PRT.

Sintaxe

Parâmetros

pReport   _In_
Tipo: const D3D12XBOX_PRT_LOD_REPORT_DESC*
Parâmetros para o endereço de destino e o tamanho do relatório na memória gráfica, bem como controles que indicam se as contagens de amostras devem ser redefinidas como parte da geração do relatório.

Comentários

O hardware de LOD de PRT gravará um relatório na memória quando esta API for executada na linha do tempo da GPU. Com base no tamanho de entrada do buffer, o hardware aplicará automaticamente buffering múltiplo às saídas para que a sincronização correta possa ser realizada. O tamanho de entrada do buffer deve seguir a fórmula N * 2 KB + 64 bytes, em que N é no mínimo 2. O valor de N define o nível de buffering múltiplo (ou seja, N igual a 2 é buffer duplo, N igual a 3 é buffer triplo). É recomendável colocar o relatório de LOD de PRT em um tipo de memória gráfica projetado para leitura pela CPU, como XALLOC_MEMTYPE_GRAPHICS_CACHEABLE ou XALLOC_MEMTYPE_GRAPHICS_GPU_UNCACHED. O relatório consiste em três componentes: um cabeçalho de 8 bytes, 56 bytes de preenchimento e uma matriz de amostras de 8 bytes. O layout do cabeçalho é definido pela estrutura D3D12XBOX_PRT_LOD_REPORT_GPU_HEADER. Cada amostra é definida pela estrutura D3D12XBOX_PRT_LOD_REPORT_GPU_SAMPLE. A cada gravação de relatório, o cabeçalho é atualizado para refletir o local do conjunto mais recente de 256 amostras gravadas. O parâmetro SampleOffset no cabeçalho indica o local, em incrementos de 32 bytes, da primeira amostra gravada pelo relatório mais recente. Por exemplo, se SampleOffset for 2, a primeira amostra estará localizada a 64 bytes do endereço base do buffer de relatório. Cada amostra indica os resultados capturados das exibições de recursos de shader marcadas (usando a API ID3D12Device8::SetShaderResourceViewPRTLODIndexX). Consulte o tópico D3D12XBOX_PRT_LOD_REPORT_GPU_SAMPLE para obter mais detalhes sobre como interpretar os resultados.

Requisitos

Cabeçalho: d3d12_xs.h Biblioteca: d3d12_xs.lib
Plataformas compatíveis: consoles XBOX Series

Confira também

ID3D12Device8::SetShaderResourceViewPRTLODIndexX
ID3D12GraphicsCommandList6
Last modified on October 6, 2026