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

Le nom à utiliser pour décrire l'événement, sous forme de 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 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 : void

## Remarques

Avec un appareil de débogage ou instrumenté, `PIXSetRetailMarker` se comporte exactement comme [PIXSetMarker](/fr/reference/tools/pix3/functions/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](/fr/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 NDA)](/fr/tools/tools-console/pix/pix)\
[pix3](/fr/reference/tools/pix3/pix3_members)\
[PIXSetRetailMarker(void\*, UINT64, PCSTR, ...)](/fr/reference/tools/pix3/functions/pixsetretailmarker)\
[PIXBeginRetailEvent](/fr/reference/tools/pix3/functions/pixbeginretailevent)


## Related topics

- [PIXSetRetailMarker](/reference/tools/pix3/functions/pixsetretailmarker_2.md)
- [PIXSetRetailMarker function](/reference/tools/pix3/functions/pixsetretailmarker.md)
- [Función PIXSetRetailMarker](/es/reference/tools/pix3/functions/pixsetretailmarker.md)