> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PIXSetRetailMarker

> PIXSetRetailMarker

# PIXSetRetailMarker

Insère un marqueur de version commerciale lorsqu'un événement particulier défini par l'utilisateur se produit.

## Syntaxe

```cpp theme={null}
void PIXSetRetailMarker(  
         void* context,  
         UINT64 color,  
         PCWSTR formatString,  
         ...  
)  
```

### Paramètres

*context*   \
Type : 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](/fr-CA/reference/tools/pix3/functions/pix_color) pour spécifier une couleur, utilisez [PIX\_COLOR\_INDEX](/fr-CA/reference/tools/pix3/functions/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 : void

## Remarques

Avec un appareil de débogage ou instrumenté, `PIXSetRetailMarker` se comporte de façon identique à [PIXSetMarker](/fr-CA/reference/tools/pix3/functions/pixsetmarker). Pour un appareil commercial, les marqueurs seront inclus dans les fichiers HIX pour le débogage des blocages du GPU.

Les appels à `PIXSetRetailMarker` peuvent se produire n'importe où et n'ont pas à suivre un appel à [PIXBeginRetailEvent](/fr-CA/reference/tools/pix3/functions/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 Series

## Voir aussi

[Vue d'ensemble de PIX (rubrique sous NDA)](/fr-CA/tools/tools-console/pix/pix)\
[pix3](/fr-CA/reference/tools/pix3/pix3_members)\
[PIXSetRetailMarker(void\*, UINT64, PCSTR, ...)](/fr-CA/reference/tools/pix3/functions/pixsetretailmarker)\
[PIXBeginRetailEvent](/fr-CA/reference/tools/pix3/functions/pixbeginretailevent)


## Related topics

- [Fonction PIXSetRetailMarker](/fr-CA/reference/tools/pix3/functions/pixsetretailmarker.md)
- [PIXSetMarker](/fr-CA/reference/tools/pix3/functions/pixsetmarker-overloads.md)
- [Fonction PIXSetMarker](/fr-CA/reference/tools/pix3/functions/pixsetmarker.md)
- [Référence de PIXSetMarker](/fr-CA/reference/tools/pix3/functions/pixsetmarker_2.md)
- [Référence de la fonction PIXSetMarker](/fr-CA/reference/tools/pix3/functions/pixsetmarker_3.md)