Référence PIXBeginEvent
Démarre un événement défini par l’utilisateur pour une capture de minutage de l’activité du processeur ou du GPU, à afficher dans les fonctionnalités System Timing Capture de PIX.Syntaxe
Paramètres
contextType : void* Contexte de l’événement ; accepte
ID3D12GraphicsCommandList\* , ID3D12GraphicsCommandList\* et ID3D12XboxDmaCommandList\* (XBOX uniquement).
color Type : UINT64 Couleur de l’événement à utiliser dans le graphique de minutage système. Utilisez PIX_COLOR pour spécifier une couleur, PIX_COLOR_INDEX pour spécifier un index de couleur, ou transmettez 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 forme de 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 similaire à la mise en forme de
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 jusqu’à 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 des performances optimales. 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 transmettez à PIXBeginEvent. Pour des performances optimales, utilisez une chaîne allouée statiquement.
Les appels à PIXBeginEvent disposent d’au moins 512 octets d’espace garantis pour enregistrer les données d’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.
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 PIX GPU Capture de PIX3.
Chaque appel à PIXBeginEvent doit avoir un appel correspondant à PIXEndEvent. Les appels associé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 : vous pouvez donc 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
PIXBeginEventPIXBeginEvent_2
PIXBeginEvent_4
PIXEndEvent
PIX3
PIX (rubrique sous NDA)