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

# PIX_COLOR_INDEX

> PIX_COLOR_INDEX

# PIX\_COLOR\_INDEX

Spécifie un ensemble de catégories d'événements uniques et laisse PIX choisir les couleurs représentant chaque catégorie.

## Syntaxe

```cpp theme={null}
UINT PIX_COLOR_INDEX(  
         BYTE i  
)  
```

### Paramètres

*i*   \
Type : BYTE

Index de la couleur.

### Valeur de retour

Type : UINT

Retourne un UINT contenant la couleur représentant la catégorie.

## Remarques

Utilisez les fonctions PIX\_COLOR\* pour spécifier des couleurs à transmettre en tant que métadonnées à une API d'événement/de marqueur PIX. Utilisez [PIX\_COLOR](https://docs.xbox.com/fr/reference/tools/pix3/functions/pix_color.md) pour spécifier une couleur particulière pour un événement. Vous pouvez aussi utiliser `PIX_COLOR_INDEX` pour spécifier un ensemble de catégories d'événements uniques et laisser PIX choisir les couleurs représentant chaque catégorie. `PIX_COLOR_INDEX` permet d'utiliser huit index de couleur distincts. La fonction ramène les valeurs d'index dans cette plage à l'aide de *i* % 8 pour choisir l'index qui déterminera la couleur appropriée.\
Les fonctions PIX\_COLOR\* peuvent être utilisées pour déterminer le paramètre de couleur de plusieurs fonctions afin de définir leur affichage dans un graphique PIX. Ces fonctions incluent les méthodes surchargées [PIXBeginEvent](https://docs.xbox.com/fr/reference/tools/pix3/functions/pixbeginevent-overloads.md) et [PIXSetMarker](https://docs.xbox.com/fr/reference/tools/pix3/functions/pixsetmarker-overloads.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

[PIX\_COLOR](https://docs.xbox.com/fr/reference/tools/pix3/functions/pix_color.md)\
[PIXBeginEvent](https://docs.xbox.com/fr/reference/tools/pix3/functions/pixbeginevent.md)\
[PIXSetMarker](https://docs.xbox.com/fr/reference/tools/pix3/functions/pixsetmarker.md)\
[PIX3](https://docs.xbox.com/fr/reference/tools/pix3/pix3_members.md)\
[PIX (rubrique sous NDA)](https://docs.xbox.com/fr/tools/tools-console/pix/pix.md)


## Related topics

- [PIX_COLOR](https://docs.xbox.com/fr/reference/tools/pix3/functions/pix_color.md)
- [PIXSetMarker(UINT64, PCSTR, ...)](https://docs.xbox.com/fr/reference/tools/pix3/functions/pixsetmarker.md)
- [PIXSetMarker(UINT64, PCWSTR, ...)](https://docs.xbox.com/fr/reference/tools/pix3/functions/pixsetmarker_2.md)
- [PIXBeginEvent(UINT64, PCSTR, ...)](https://docs.xbox.com/fr/reference/tools/pix3/functions/pixbeginevent.md)
- [PIXBeginEvent(UINT64, PCWSTR, ...)](https://docs.xbox.com/fr/reference/tools/pix3/functions/pixbeginevent_2.md)
