PIXBeginRetailEvent
Démarre un événement de version commerciale défini par l’utilisateur.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 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
Avec un appareil de débogage ou instrumenté,PIXBeginRetailEvent se comporte de manière identique à PIXBeginEvent. Sur un appareil commercial, les événements sont inclus dans les fichiers HIX pour le débogage des blocages du GPU.
Les paires PIXBeginRetailEvent et PIXEndRetailEvent 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
PIX (rubrique sous NDA)pix3
PIXEndRetailEvent
PIXBeginRetailEvent(void*, UINT64, PCSTR, …)