Fonction PIXSetRetailMarker
Insère un marqueur de version commerciale lorsqu’un événement particulier défini par l’utilisateur se produit.Syntaxe
Paramètres
contextType : void* Contexte de l’événement ; accepte 1ID3D12GraphicsCommandList*
,ID3D12CommandQueue*etID3D12XboxDmaCommandList*` (XBOX uniquement).
color Type : UINT64 La 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 un DWORD brut, en notant que le format est ARGB et que la valeur du canal alpha doit être 0xff. formatString _In_
Type : PCSTR Le nom à utiliser pour décrire l’événement. La chaîne peut spécifier zéro ou plusieurs espaces réservés de mise en forme facultatifs, très similaires à 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 (16 au maximum) dont les types correspondent aux espaces réservés.
Valeur de retour
Type : voidRemarques
Avec un appareil de débogage ou instrumenté,PIXSetRetailMarker se comporte exactement comme PIXSetMarker. Pour un appareil commercial, les marqueurs sont inclus dans les fichiers HIX pour le débogage des blocages du GPU.
Les appels à PIXSetRetailMarker peuvent avoir lieu n’importe où et n’ont pas besoin de suivre un appel à PIXBeginRetailEvent.
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
PIXSetRetailMarker(void*, UINT64, PCWSTR, …)pix3
PIX (rubrique NDA)