Référence de la 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 : PCWSTR Nom à utiliser pour décrire l’événement, sous la forme d’un 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 format de chaîne facultatifs, de manière très semblable à la mise en forme
sprintf.
Type : …
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 plus d’informations sur le minutage des événements du GPU, consultez la section API de capture GPU de PIX de 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
PIXEndEventPIXBeginEvent
PIXBeginEvent_3
PIXBeginEvent_4
PIX3
PIX (rubrique sous NDA)