Partager via


énumération D3D12DDI_MEASUREMENTS_ACTION_0062 (d3d12umddi.h)

Indique ce qu’il faut faire avec le résultat des mesures PGO précédentes (optimisation guidée par profil).

Syntaxe

typedef enum D3D12DDI_MEASUREMENTS_ACTION_0062 {
  D3D12DDI_MEASUREMENTS_ACTION_0062_KEEP_ALL,
  D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS,
  D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS_HIGH_PRIORITY,
  D3D12DDI_MEASUREMENTS_ACTION_0062_DISCARD_PREVIOUS
} ;

Constantes

 
D3D12DDI_MEASUREMENTS_ACTION_0062_KEEP_ALL
D3D12DDI_MEASUREMENTS_ACTION_0062_KEEP_ALL ne demande aucune modification spécifique du comportement. Les résultats précédents sont toujours valides et le pilote peut continuer à suivre les statistiques qui se trouvent au milieu de la mesure.
D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS
D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS indicateurs que la charge de travail vue jusqu’à présent représente l’ensemble complet de ce qui vaut la peine d’optimiser en fonction, par exemple, qu’une barre volante de scène s’est terminée dans un outil d’évaluation ou que la lecture de l’image unique analysée s’est terminée dans PIX. L’UMD doit lancer tout traitement en arrière-plan souhaité en fonction de ce qu’il a vu jusqu’à présent, car aucun travail différent ne sera entrant dans un avenir proche. Une fois que l’UMD retourne à partir d’un appel SetBackgroundProcessingMode qui spécifie D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS, toutes les tâches en arrière-plan actuellement mises en file d’attente sont considérées comme faisant partie de la validation. Une fois l’exécution de cet ensemble de tâches terminée, le hEventToSignalOnCompletion fourni est signalé.

Si l’UMD a collecté des statistiques à propos de l’exemple. valeurs constantes couramment utilisées et attend que certaines quantités de données seuil soient enregistrées avant d’agir sur ces informations, l’indicateur de validation doit effectuer un scale-up des histogrammes de fréquence enregistré jusqu’à présent pour donner le même résultat que si le seuil d’acte normal avait été atteint après une plus longue période de collecte de données. Il est important de laisser PIX relire qu’une seule capture d’images, mais ensuite demander un ensemble final de nuanceurs optimisés correspondant à ce travail, sans avoir à perdre du temps à répéter une seule image plusieurs centaines de fois.

Si les modes D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS ou D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS_HIGH_PRIORITY ne sont pas utilisés, hEventToSignalOnCompletion doit avoir la valeur Null.
D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS_HIGH_PRIORITY
D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS_HIGH_PRIORITY est un super-ensemble du mode D3D12DDI_MEASUREMENTS_ACTION_0062_COMMIT_RESULTS qui modifie le comportement de planification des threads. Ce mode indique que l’obtention rapide des compilations en arrière-plan est plus importante que d’éviter des problèmes. Par conséquent, le runtime D3D planifie plusieurs tâches simultanément à l’aide de plusieurs threads et les exécute à des priorités supérieures à celles d’inactivité. Cette augmentation dure jusqu’à ce que toutes les tâches générées par la validation aient terminé l’exécution.

Le mode haute priorité est valide uniquement lorsque le mode développeur est activé
D3D12DDI_MEASUREMENTS_ACTION_0062_DISCARD_PREVIOUS
D3D12DDI_MEASUREMENTS_ACTION_0062_DISCARD_PREVIOUS indicateurs à l’UMD que la charge de travail a changé de manière significative, de sorte que les résultats des mesures précédentes ne sont plus significatifs.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 1903
d’en-tête d3d12umddi.h