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 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 Nom à utiliser pour décrire l’événement, sous forme de pointeur vers une chaîne Unicode terminée par un caractère nul. La chaîne peut spécifier zéro ou plusieurs espaces réservés de format de chaîne facultatifs, très semblables à 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 indiqué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 mise en correspondance du début et de 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 pendant 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, convertissez le pointeur en void\* ou en tout type intégral ou à virgule flottante lorsque vous le passez à PIXScopedEvent.
Les appels à PIXScopedEvent disposent d’au moins 512 octets d’espace garantis pour enregistrer les données de l’enregistrement, ce qui comprend 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 à de courts marqueurs à hautes performances 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 sous NDA)