Skip to main content
Écrit un rapport de statistiques de LOD PRT dans une mémoire tampon. Le rapport contient des informations sur le nombre d’échantillons de LOD de mip et sur le bornage pour les ressources qui ont été marquées pour le suivi par le matériel de LOD PRT.

Syntaxe

Paramètres

pReport   _In_
Type : const D3D12XBOX_PRT_LOD_REPORT_DESC*
Paramètres de l’adresse de destination et de la taille du rapport dans la mémoire graphique, ainsi que des contrôles permettant de déterminer s’il faut réinitialiser le nombre d’échantillons lors de la génération du rapport.

Remarques

Le matériel de LOD PRT écrit un rapport en mémoire lorsque cette API est exécutée sur la chronologie du GPU. En fonction de la taille de la mémoire tampon fournie, le matériel met automatiquement les sorties en mémoire tampon multiple afin qu’une synchronisation correcte puisse être effectuée. La taille de la mémoire tampon fournie doit respecter la formule N * 2 Ko + 64 octets, où N vaut au moins 2. La valeur de N définit le niveau de mise en mémoire tampon multiple (c.-à-d. N égal à 2 correspond à une double mise en mémoire tampon, N égal à 3 à une triple mise en mémoire tampon). Il est recommandé de placer le rapport de LOD PRT dans un type de mémoire graphique conçu pour la relecture par le processeur, comme XALLOC_MEMTYPE_GRAPHICS_CACHEABLE ou XALLOC_MEMTYPE_GRAPHICS_GPU_UNCACHED. Le rapport comporte trois composants : un en-tête de 8 octets, 56 octets de remplissage et un tableau d’échantillons de 8 octets. La disposition de l’en-tête est définie par la structure D3D12XBOX_PRT_LOD_REPORT_GPU_HEADER. Chaque échantillon est défini par la structure D3D12XBOX_PRT_LOD_REPORT_GPU_SAMPLE. À chaque écriture de rapport, l’en-tête est mis à jour pour refléter l’emplacement du plus récent ensemble de 256 échantillons écrits. Le paramètre SampleOffset de l’en-tête indique l’emplacement, par incréments de 32 octets, du premier échantillon écrit par le rapport le plus récent. Par exemple, si SampleOffset vaut 2, le premier échantillon se trouve à 64 octets de l’adresse de base de la mémoire tampon du rapport. Chaque échantillon indique les résultats capturés à partir des vues de ressources de nuanceur marquées (à l’aide de l’API ID3D12Device8::SetShaderResourceViewPRTLODIndexX). Consultez la rubrique D3D12XBOX_PRT_LOD_REPORT_GPU_SAMPLE pour plus de détails sur l’interprétation des résultats.

Configuration requise

En-tête : d3d12_xs.h Bibliothèque : d3d12_xs.lib
Plateformes prises en charge : consoles XBOX Series

Voir aussi

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