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

# Référence de PIXScopedEvent

> Référence de PIXScopedEvent

# Référence de 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_ PCWSTR formatString,
         ...
)
```

<a id="parametersSection" />

### Paramètres

*color*   \
Type : UINT64

Couleur de l'événement à utiliser dans le graphique chronologique. Spécifiez une constante [PIX\_COLOR](/fr-CA/reference/tools/pix3/functions/pix_color) pour utiliser une couleur prédéfinie, une constante [PIX\_COLOR\_INDEX](/fr-CA/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

Nom à utiliser pour décrire l'événement, sous forme de pointeur vers une chaîne Unicode terminée par un caractère nul. La chaîne peut spécifier zéro ou plusieurs espaces réservés de format de chaîne facultatifs, très semblables à 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 indiqués par les espaces réservés correspondants.

<a id="retvalSection" />

### Valeur de retour

Type : void

<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 mise en correspondance du début et de 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 pendant 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`, convertissez le pointeur en `void\*` ou en tout type intégral ou à virgule flottante lorsque vous le passez à `PIXScopedEvent`.

Les appels à `PIXScopedEvent` disposent d'au moins 512 octets d'espace garantis pour enregistrer les données de l'enregistrement, ce qui comprend 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 à de courts marqueurs à hautes performances 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-CA/reference/tools/pix3/functions/pixscopedevent-overloads)\
[PIX3](/fr-CA/reference/tools/pix3/pix3_members)\
[PIX (rubrique sous NDA)](/fr-CA/tools/tools-console/pix/pix)