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

> Vue d'ensemble de PIXSetMarker

# Vue d'ensemble de PIXSetMarker

Insère un marqueur dans la chronologie du GPU de la fenêtre **PIX System Timing Capture** lorsqu'un événement particulier défini par l'utilisateur se produit.

## Syntaxe

```cpp theme={null}
void PIXSetMarker(  
         void* context,  
         UINT64 color,  
         PCWSTR formatString,  
         ...  
)  
```

### Paramètres

*context*   \
Type : void\*

Contexte de l'événement ; accepte **ID3D12GraphicsCommandList\*** , **ID3D12CommandQueue\*** et **ID3D12XboxDmaCommandList\*** (XBOX uniquement).

*color*   \
Type : UINT64

La couleur qui sera utilisée dans le graphique de minutage lorsque cet événement se produit dans les fenêtres PIX.

Utilisez [PIX\_COLOR](/fr/reference/tools/pix3/functions/pix_color) pour spécifier une couleur, utilisez [PIX\_COLOR\_INDEX](/fr/reference/tools/pix3/functions/pix_color_index) pour spécifier un index de couleur, ou passez un DWORD brut, en notant que le format est ARGB et que la valeur du canal alpha doit être 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**.

Type : ...

Si des espaces réservés sont utilisés dans **formatString**, il doit y avoir un nombre correspondant de paramètres (16 au maximum) dont les types correspondent aux espaces réservés.

### Valeur de retour

Type : void

## Remarques

La fonction `PIXSetMarker` 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 du fichier de capture dans PIX. Utilisez des chaînes alignées sur 16 octets (de préférence) ou sur 8 octets avec `PIXSetMarker` pour obtenir les meilleures performances. Pour afficher 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 passez à `PIXSetMarker`. Tout appel à `PIXSetMarker` dispose d'au moins 512 octets d'espace garanti pour enregistrer les données de l'enregistrement.

L'événement sera affiché sans durée et sera représenté par une seule ligne (une seule barre verticale) dans la fenêtre **PIX System Timing Capture**.

Cette fonction permet de marquer des événements dans la chronologie du GPU. Pour marquer des événements dans la chronologie du CPU, appelez la [première surcharge de la fonction PIXSetMarker](/fr/reference/tools/pix3/functions/pixsetmarker) ou la [deuxième surcharge de la fonction PIXSetMarker](/fr/reference/tools/pix3/functions/pixsetmarker_2).

Les appels à `PIXSetMarker` peuvent avoir lieu n'importe où et n'ont pas besoin de suivre un appel à [PIXBeginEvent](/fr/reference/tools/pix3/functions/pixbeginevent).

## 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 NDA)](/fr/tools/tools-console/pix/pix)\
[pix3](/fr/reference/tools/pix3/pix3_members)\
[PIXSetMarker](/fr/reference/tools/pix3/functions/pixsetmarker)\
[PIXSetMarker\_2](/fr/reference/tools/pix3/functions/pixsetmarker_2)\
[PIXSetMarker\_3](/fr/reference/tools/pix3/functions/pixsetmarker_3)\
[PIXBeginEvent](/fr/reference/tools/pix3/functions/pixbeginevent)


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