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

> Fonction PIXScopedEvent

# Fonction PIXScopedEvent

Crée un événement défini par l'utilisateur pour une capture de minutage de l'activité du CPU, à afficher dans la fonctionnalité **Timing Capture** de Performance Investigator for XBOX (PIX).

<a id="syntaxSection" />

## Syntaxe

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

<a id="parametersSection" />

### Paramètres

*color*   \
Type : UINT64

La couleur de l'événement à utiliser dans le graphique chronologique. Spécifiez une constante [PIX\_COLOR](/fr/reference/tools/pix3/functions/pix_color) pour utiliser une couleur prédéfinie, une constante [PIX\_COLOR\_INDEX](/fr/reference/tools/pix3/functions/pix_color_index) pour utiliser un index de couleur, ou une valeur DWORD au format ARGB pour utiliser une couleur personnalisée. Si une valeur DWORD au format ARGB est spécifiée, le canal alpha de cette valeur doit être défini sur `0xff`.

*formatString*   \_In\_\
Type : PCWSTR

Le 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 mise en forme facultatifs, très similaires à la mise en forme de `sprintf`. Cette méthode prend en charge jusqu'à 16 espaces réservés.

Type : ...

Si des espaces réservés sont spécifiés dans *formatString*, vous devez spécifier un nombre correspondant de valeurs dans ce paramètre. Les types des valeurs spécifiées dans ce paramètre dépendent des types identifiés par les espaces réservés correspondants.

<a id="retvalSection" />

### Valeur de retour

Type : void

Aucune.

<a id="remarksSection" />

## Remarques

Cette fonction crée un événement défini par l'utilisateur pour une capture de minutage de l'activité du CPU, à afficher dans la fonctionnalité **Timing Capture** de PIX. Les événements créés avec `PIXScopedEvent` se terminent automatiquement à la sortie de la portée dans laquelle l'API est appelée, ce qui rend automatique la correspondance entre le début et la fin de l'événement.

La fonction `PIXScopedEvent` 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 8 octets ou, de préférence, sur 16 octets avec `PIXScopedEvent` pour obtenir les meilleures performances. Pour mettre en forme 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 tout type intégral ou à virgule flottante lorsque vous passez le pointeur à `PIXScopedEvent`.

Les appels à `PIXScopedEvent` disposent d'au moins 512 octets d'espace garanti pour enregistrer les données de l'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.

<a id="requirementsSection" />

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

<a id="seealsoSection" />

## Voir aussi

[PIXScopedEvent](/fr/reference/tools/pix3/functions/pixscopedevent-overloads)\
[PIX3](/fr/reference/tools/pix3/pix3_members)\
[PIX (rubrique NDA)](/fr/tools/tools-console/pix/pix)


## Related topics

- [PIXScopedEvent](/reference/tools/pix3/functions/pixscopedevent-overloads.md)
- [PIXScopedEvent function](/reference/tools/pix3/functions/pixscopedevent.md)
- [PIXScopedEvent reference](/reference/tools/pix3/functions/pixscopedevent_2.md)
- [PIXScopedEvent overview](/reference/tools/pix3/functions/pixscopedevent_4.md)
- [Función PIXScopedEvent](/es/reference/tools/pix3/functions/pixscopedevent.md)