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

> Fonction PIXBeginEvent

# Fonction PIXBeginEvent

Démarre un événement défini par l'utilisateur pour une capture de minutage de l'activité du processeur, à afficher dans la fonctionnalité System Timing Capture de PIX.

## Syntaxe

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

### Paramètres

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

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

La fonction `PIXBeginEvent` enregistre la chaîne de format et les paramètres de format au lieu de mettre en forme la chaîne au moment de l'exécution. La mise en forme est ensuite effectuée lors de la lecture des fichiers de capture dans PIX. Utilisez des chaînes alignées sur 16 octets (de préférence) ou sur 8 octets avec `PIXBeginEvent` pour obtenir des performances optimales. Pour imprimer un char\* ou un wchar\_t\* en tant que pointeur à l'aide du spécificateur de format %p, effectuez un cast du pointeur en void\* ou en pointeur vers un type intégral ou à virgule flottante lorsque vous le transmettez à `PIXBeginEvent`. Pour des performances optimales, utilisez une chaîne allouée statiquement.

Les appels à `PIXBeginEvent` disposent d'au moins 512 octets d'espace garantis pour enregistrer les données d'enregistrement, ce qui inclut la taille complète et l'alignement de la chaîne de format et de toutes les variables. En général, les événements PIX sont destinés à des marqueurs courts et performants qui correspondent aux principaux composants, systèmes ou contenus de votre jeu.

Cette méthode sert à minuter les événements du processeur. Pour minuter les événements du GPU, consultez les API PIX GPU Capture sur la page [PIX3](/fr/reference/tools/pix3/pix3_members).

Chaque appel à `PIXBeginEvent` doit avoir un appel correspondant à [PIXEndEvent](/fr/reference/tools/pix3/functions/pixendevent). Les appels associés à `PIXBeginEvent` et à [PIXEndEvent](/fr/reference/tools/pix3/functions/pixendevent) doivent avoir lieu sur le même thread. L'intervalle de minutage est d'environ 200 ns et l'utilisation de cette fonction entraîne une faible surcharge : vous pouvez donc effectuer jusqu'à plusieurs centaines de milliers d'appels à `PIXBeginEvent` par seconde.

Les paires `PIXBeginEvent` et `PIXEndEvent` 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

[Vue d'ensemble de PIX (rubrique sous NDA)](/fr/tools/tools-console/pix/pix)\
[pix3](/fr/reference/tools/pix3/pix3_members)\
[PIXEndEvent](/fr/reference/tools/pix3/functions/pixendevent)\
[PIXBeginEvent\_2](/fr/reference/tools/pix3/functions/pixbeginevent_2)\
[PIXBeginEvent\_3](/fr/reference/tools/pix3/functions/pixbeginevent_3)\
[PIXBeginEvent\_4](/fr/reference/tools/pix3/functions/pixbeginevent_4)


## Related topics

- [PIXBeginEvent overview](/reference/tools/pix3/functions/pixbeginevent_4.md)
- [PIXBeginEvent 概览](/zh-CN/reference/tools/pix3/functions/pixbeginevent_4.md)
- [PIXBeginEvent function](/reference/tools/pix3/functions/pixbeginevent.md)
- [PIXBeginEvent reference](/reference/tools/pix3/functions/pixbeginevent_3.md)
- [PIXBeginEvent 函数](/zh-CN/reference/tools/pix3/functions/pixbeginevent.md)