> ## 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 commercial (retail) 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 système. Utilisez [PIX\_COLOR](/fr/reference/tools/pix3/functions/pix_color) pour spécifier une couleur, [PIX\_COLOR\_INDEX](/fr/reference/tools/pix3/functions/pix_color_index) pour spécifier un index de couleur, ou transmettez 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 forme de 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 similaire à 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 dont les types dépendent des espaces réservés. Cette méthode prend en charge jusqu'à 16 paramètres de format.

### Valeur de retour

Type : void

## Remarques

Avec un appareil de débogage ou instrumenté, `PIXBeginRetailEvent` se comporte exactement comme [PIXBeginEvent](/fr/reference/tools/pix3/functions/pixbeginevent). Sur un appareil commercial (retail), 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/reference/tools/pix3/functions/pixbeginretailevent_2)\
[PIXEndRetailEvent](/fr/reference/tools/pix3/functions/pixendretailevent)\
[pix3](/fr/reference/tools/pix3/pix3_members)\
[PIX (rubrique sous NDA)](/fr/tools/tools-console/pix/pix)


## Related topics

- [PIXBeginRetailEvent](/reference/tools/pix3/functions/pixbeginretailevent_2.md)
- [PIXBeginRetailEvent function](/reference/tools/pix3/functions/pixbeginretailevent.md)
- [PIXBeginRetailEvent 函数](/zh-CN/reference/tools/pix3/functions/pixbeginretailevent.md)
- [Función PIXBeginRetailEvent](/es/reference/tools/pix3/functions/pixbeginretailevent.md)
- [PIXBeginRetailEvent 関数](/ja-jp/reference/tools/pix3/functions/pixbeginretailevent.md)