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

# PIXSetRetailMarker(void*, UINT64, PCSTR, ...)

> Fonction PIXSetRetailMarker

# Fonction 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,  
         PCSTR formatString,  
         ...  
)  
```

### Paramètres

*context*   \
Type : void\*

Contexte de l'événement; accepte 1ID3D12GraphicsCommandList\*`,`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](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pix_color.md) pour spécifier une couleur, utilisez [PIX\_COLOR\_INDEX](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pix_color_index.md) 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 : PCSTR

Nom à utiliser pour décrire l'événement. 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](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pixsetmarker.md). 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](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pixbeginretailevent.md).

## 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

[PIXSetRetailMarker(void\*, UINT64, PCWSTR, ...)](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pixsetretailmarker_2.md)\
[pix3](https://docs.xbox.com/fr-CA/reference/tools/pix3/pix3_members.md)\
[PIX (rubrique sous NDA)](https://docs.xbox.com/fr-CA/tools/tools-console/pix/pix.md)


## Related topics

- [PIXSetRetailMarker(void*, UINT64, PCWSTR, ...)](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pixsetretailmarker_2.md)
- [PIXSetMarker](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pixsetmarker-overloads.md)
- [PIXSetMarker(void*, UINT64, PCSTR, ...)](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pixsetmarker_3.md)
- [PIXSetMarker(UINT64, PCSTR, ...)](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pixsetmarker.md)
- [PIXBeginRetailEvent(void*, UINT64, PCSTR, ...)](https://docs.xbox.com/fr-CA/reference/tools/pix3/functions/pixbeginretailevent.md)