Fonction PIXBeginEvent
Démarre un événement défini par l’utilisateur pour une capture de minutage de l’activité du processeur, à afficher dans la fonctionnalité System Timing Capture de PIX.Syntaxe
Paramètres
colorType : UINT64 Couleur de l’événement à utiliser dans le graphique de minutage du système. Utilisez PIX_COLOR pour spécifier une couleur, PIX_COLOR_INDEX pour spécifier un index de couleur, ou passez une valeur DWORD brute, en notant que le format est ARGB et que la valeur du canal alpha doit être 0xff. formatString _In_
Type : PCSTR Nom à utiliser pour décrire l’événement, sous la forme d’un pointeur vers une chaîne terminée par un caractère null. La chaîne peut spécifier zéro ou plusieurs espaces réservés de format de chaîne facultatifs, de manière très semblable à la mise en forme sprintf. Si des espaces réservés sont utilisés dans formatString, il doit y avoir un nombre correspondant de paramètres dont les types dépendent des espaces réservés. Cette méthode prend en charge un maximum de 16 paramètres de format.
Valeur de retour
Type : voidRemarques
La fonctionPIXBeginEvent 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 16 octets (de préférence) ou sur 8 octets avec PIXBeginEvent pour obtenir les meilleures performances. Pour imprimer 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 pointeur vers un type intégral ou à virgule flottante lorsque vous le passez à PIXBeginEvent. Pour obtenir les meilleures performances, utilisez une chaîne allouée de manière statique.
Les appels à PIXBeginEvent 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 hautes performances qui correspondent aux principaux composants, systèmes ou contenus de votre jeu.
Cette méthode sert à minuter les événements du processeur. Pour minuter les événements du GPU, consultez les API de capture GPU de PIX sur la page PIX3.
Chaque appel à PIXBeginEvent doit avoir un appel correspondant à PIXEndEvent. Les appels jumelés à PIXBeginEvent et PIXEndEvent doivent avoir lieu sur le même thread. L’intervalle de minutage est d’environ 200 ns et l’utilisation de cette fonction entraîne une faible surcharge; il est donc possible d’effectuer jusqu’à plusieurs centaines de milliers d’appels à PIXBeginEvent par seconde.
Les paires PIXBeginEvent et PIXEndEvent peuvent être imbriquées à n’importe quelle profondeur.
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
Vue d’ensemble de PIX (rubrique sous NDA)pix3
PIXEndEvent
PIXBeginEvent_2
PIXBeginEvent_3
PIXBeginEvent_4