Fonction PIXScopedEvent
Crée un événement défini par l’utilisateur pour une capture de minutage de l’activité du CPU, à afficher dans la fonctionnalité Timing Capture de Performance Investigator for XBOX (PIX).Syntaxe
Paramètres
colorType : UINT64 La couleur de l’événement à utiliser dans le graphique chronologique. Spécifiez une constante PIX_COLOR pour utiliser une couleur prédéfinie, une constante PIX_COLOR_INDEX pour utiliser un index de couleur, ou une valeur DWORD au format ARGB pour utiliser une couleur personnalisée. Si une valeur DWORD au format ARGB est spécifiée, le canal alpha de cette valeur doit être défini sur
0xff.
formatString _In_Type : PCWSTR Le nom à utiliser pour décrire l’événement, sous forme de pointeur vers une chaîne Unicode terminée par un caractère null. La chaîne peut spécifier zéro ou plusieurs espaces réservés de mise en forme facultatifs, très similaires à la mise en forme de
sprintf. Cette méthode prend en charge jusqu’à 16 espaces réservés.
Type : …
Si des espaces réservés sont spécifiés dans formatString, vous devez spécifier un nombre correspondant de valeurs dans ce paramètre. Les types des valeurs spécifiées dans ce paramètre dépendent des types identifiés par les espaces réservés correspondants.
Valeur de retour
Type : void Aucune.Remarques
Cette fonction crée un événement défini par l’utilisateur pour une capture de minutage de l’activité du CPU, à afficher dans la fonctionnalité Timing Capture de PIX. Les événements créés avecPIXScopedEvent se terminent automatiquement à la sortie de la portée dans laquelle l’API est appelée, ce qui rend automatique la correspondance entre le début et la fin de l’événement.
La fonction PIXScopedEvent enregistre la chaîne de format et les paramètres de format au lieu de mettre en forme la chaîne au moment de l’exécution. La mise en forme est ensuite effectuée lors de la lecture des fichiers de capture dans PIX. Utilisez des chaînes alignées sur 8 octets ou, de préférence, sur 16 octets avec PIXScopedEvent pour obtenir les meilleures performances. Pour mettre en forme un char\* ou un wchar_t\* en tant que pointeur à l’aide du spécificateur de format %p, effectuez un cast du pointeur en void\* ou en tout type intégral ou à virgule flottante lorsque vous passez le pointeur à PIXScopedEvent.
Les appels à PIXScopedEvent disposent d’au moins 512 octets d’espace garanti pour enregistrer les données de l’enregistrement, ce qui inclut la taille complète et l’alignement de la chaîne de format et de toutes les variables. En général, les événements PIX sont destinés à des marqueurs courts et performants qui correspondent aux principaux composants, systèmes ou contenus de votre jeu.
Configuration requise
En-tête : pix3.h Bibliothèque : pixevt.lib Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
PIXScopedEventPIX3
PIX (rubrique NDA)