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

# Vue d'ensemble de PIXBeginEvent

> Vue d'ensemble de PIXBeginEvent

# Vue d'ensemble de 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(  
         void* context,  
         UINT64 color,  
         PCWSTR 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 : PCWSTR

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

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 plus d'informations sur le minutage des événements du GPU, consultez la section [API PIX GPU Capture](/fr/reference/tools/pix3/pix3_members#pixgpucaptureapis) de [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

[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](/fr/reference/tools/pix3/functions/pixbeginevent)\
[PIXBeginEvent\_2](/fr/reference/tools/pix3/functions/pixbeginevent_2)\
[PIXBeginEvent\_3](/fr/reference/tools/pix3/functions/pixbeginevent_3)


## Related topics

- [Vue d'ensemble de XBOX Series X|S](/fr/paths/series-xs/overview.md)
- [Vue d'ensemble de l'accessibilité GDK](/fr/build/game-principles/accessibility/accessibility-overview.md)
- [Vue d'ensemble de Windows & ROG XBOX Ally](/fr/paths/windows/overview.md)
- [Vue d'ensemble de Godot et des moteurs communautaires](/fr/paths/community-engines/overview.md)
- [Vue d'ensemble de Play Anywhere (console + PC)](/fr/paths/play-anywhere/overview.md)