Vue d’ensemble de PIXSetMarker
Insère un marqueur dans la chronologie du GPU de la fenêtre PIX System Timing Capture lorsqu’un événement particulier défini par l’utilisateur se produit.Syntaxe
Paramètres
contextType : void* Contexte de l’événement; accepte ID3D12GraphicsCommandList* , ID3D12CommandQueue* et ID3D12XboxDmaCommandList* (XBOX seulement). color
Type : UINT64 Couleur qui sera utilisée dans le graphique de minutage lorsque cet événement se produit dans les fenêtres PIX. Utilisez PIX_COLOR pour spécifier une couleur, utilisez 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 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. Type : … Si des espaces réservés sont utilisés dans formatString, il doit y avoir un nombre correspondant de paramètres (jusqu’à un maximum de 16) dont les types correspondent aux espaces réservés.
Valeur de retour
Type : voidRemarques
La fonctionPIXSetMarker 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 du fichier de capture dans PIX. Utilisez des chaînes alignées sur 16 octets (de préférence) ou sur 8 octets avec PIXSetMarker pour obtenir les meilleures performances. Pour afficher 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 pointeur vers un type intégral ou à virgule flottante lorsque vous le passez à PIXSetMarker. Tout appel à PIXSetMarker dispose d’au moins 512 octets d’espace garantis pour enregistrer les données de l’enregistrement.
L’événement sera affiché comme n’ayant aucune durée et sera représenté par une seule ligne (une seule barre verticale) dans la fenêtre PIX System Timing Capture.
Cette fonction sert à marquer des événements dans la chronologie du GPU. Pour marquer des événements dans la chronologie du CPU, appelez la première surcharge de la fonction PIXSetMarker ou la deuxième surcharge de la fonction PIXSetMarker.
Les appels à PIXSetMarker peuvent se produire n’importe où et n’ont pas à suivre un appel à PIXBeginEvent.
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
PIXSetMarker
PIXSetMarker_2
PIXSetMarker_3
PIXBeginEvent