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

# Fonction PIXBeginRetailEvent

> Fonction PIXBeginRetailEvent

# Fonction PIXBeginRetailEvent

Démarre un événement de version commerciale défini par l'utilisateur.

## Syntaxe

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

### Paramètres

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

Nom à utiliser pour décrire l'événement, sous la forme d'un pointeur vers une chaîne 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 : void

## Remarques

Avec un appareil de débogage ou instrumenté, `PIXBeginRetailEvent` se comporte de manière identique à [PIXBeginEvent](/fr-CA/reference/tools/pix3/functions/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 Series

## Voir aussi

[PIXBeginRetailEvent(void\*,UINT64, PCWSTR, ...)](/fr-CA/reference/tools/pix3/functions/pixbeginretailevent_2)\
[PIXEndRetailEvent](/fr-CA/reference/tools/pix3/functions/pixendretailevent)\
[pix3](/fr-CA/reference/tools/pix3/pix3_members)\
[PIX (rubrique sous NDA)](/fr-CA/tools/tools-console/pix/pix)


## Related topics

- [PIXBeginRetailEvent](/fr-CA/reference/tools/pix3/functions/pixbeginretailevent_2.md)
- [Fonction PIXBeginEvent](/fr-CA/reference/tools/pix3/functions/pixbeginevent-overloads.md)
- [Référence de la fonction PIXBeginEvent](/fr-CA/reference/tools/pix3/functions/pixbeginevent_2.md)
- [Fonction PIXSetRetailMarker](/fr-CA/reference/tools/pix3/functions/pixsetretailmarker.md)
- [PIXEndRetailEvent](/fr-CA/reference/tools/pix3/functions/pixendretailevent.md)