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

# PIXCaptureParameters

> PIXCaptureParameters

# PIXCaptureParameters

Paramètres de [PIXBeginCapture](/fr/reference/tools/pix3/functions/pixbegincapture).

## Syntaxe

```cpp theme={null}
union PIXCaptureParameters
{
    enum PIXCaptureStorage
    {
        Memory = 0,
        MemoryCircular = 1, // Xbox only
        FileCircular = 2, // PC only
    };

    struct GpuCaptureParameters
    {
        PCWSTR FileName;
    } GpuCaptureParameters;

    struct TimingCaptureParameters
    {
        PCWSTR FileName;
        UINT32 MaximumToolingMemorySizeMb;
        PIXCaptureStorage CaptureStorage;

        BOOL CaptureGpuTiming;

        BOOL CaptureCallstacks;
        BOOL CaptureCpuSamples;
        UINT32 CpuSamplesPerSecond;

        BOOL CaptureFileIO;

        BOOL CaptureVirtualAllocEvents;
        BOOL CaptureHeapAllocEvents;
        BOOL CaptureXMemEvents; // Xbox only
        BOOL CapturePixMemEvents;
        BOOL CapturePageFaultEvents;
        BOOL CaptureVideoFrames; // Xbox only
    } TimingCaptureParameters;
};

typedef PIXCaptureParameters* PPIXCaptureParameters;
```

### Membres

*FileName*\
Type : PWSTR

Le nom du fichier de la capture sur la console.

*MaximumToolingMemorySizeMb*\
Type : UINT32

La taille maximale, en Mo, de la mémoire tampon dans la mémoire des outils qui sera utilisée pour stocker les données de capture.\
Selon la valeur de *CaptureStorage*, la capture s'arrête lorsque la mémoire tampon est pleine, ou utilise la mémoire des outils comme mémoire tampon circulaire.

*CaptureStorage*\
Type : PIXCaptureStorage

Le mode de capture.  Lorsque la valeur est *Memory*, `PIXBeginCapture` remplit la mémoire des outils mise à disposition, puis ignore toutes les nouvelles données reçues.  Lorsque la valeur est *MemoryCircular*, `PIXBeginCapture` utilise la mémoire des outils comme mémoire tampon circulaire.  La capture s'exécute jusqu'à ce que la mémoire des outils soit pleine, mais au lieu d'arrêter la capture, les données les plus anciennes sont supprimées pour faire de la place aux nouvelles données.

*CaptureGpuTiming*\
Type : BOOL

Détermine s'il faut capturer ou non les données de minutage du GPU, notamment les événements GPU PIX, le travail du GPU, les marqueurs GPU PIX et les marqueurs d'API.

*CaptureCallstacks*\
Type : BOOL

Détermine s'il faut capturer ou non les piles d'appels pour les changements de contexte.

*CaptureCpuSamples*\
Type : BOOL

Détermine s'il faut capturer ou non des échantillons du CPU.

*CpuSamplesPerSecond*\
Type : UINT32

Le nombre d'échantillons du CPU à capturer par seconde.

*CaptureFileIO*\
Type : BOOL

Détermine s'il faut capturer ou non les E/S de fichiers DirectStorage et Win32.

*CaptureVirtualAllocEvents*\
Type : BOOL

Détermine s'il faut capturer ou non les événements d'allocation virtuelle.

*CaptureHeapAllocEvents*\
Type : BOOL

Détermine s'il faut capturer ou non les événements d'allocation de tas.

*CaptureXMemEvents*\
Type : BOOL

Détermine s'il faut capturer ou non les événements d'allocation XMem.

*CapturePixMemEvents*\
Type : BOOL

Détermine s'il faut capturer ou non les allocations effectuées avec des allocateurs de mémoire personnalisés définis par le titre.

*CapturePageFaultEvents*\
Type : BOOL

Détermine s'il faut capturer ou non les événements de défaut de page.

*CaptureVideoFrames*\
Type : BOOL

Détermine s'il faut capturer ou non les images vidéo.

## Remarques

Cette union est utilisée par [PIXBeginCapture](/fr/reference/tools/pix3/functions/pixbegincapture) pour démarrer une capture de minutage PIX contrôlée par programmation.

`PixBeginCapture` utilise également les indicateurs retournés par [PixGetCaptureState](/fr/reference/tools/pix3/functions/pixgetcapturestate).

## Configuration requise

**En-tête :** pix3.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[PIXBeginCapture](/fr/reference/tools/pix3/functions/pixbegincapture)\
[PIX (rubrique NDA)](/fr/tools/tools-console/pix/pix)\
[pix3](/fr/reference/tools/pix3/pix3_members)


## Related topics

- [PIXBeginCapture](/fr/reference/tools/pix3/functions/pixbegincapture.md)
- [PIX3](/fr/reference/tools/pix3/pix3_members.md)
- [FXLOUDNESS_PARAMETERS](/fr/reference/audio/xaudio2xbox/structs/fxloudness_parameters.md)
- [XAppCapture](/fr/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureVideoCaptureSettings](/fr/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)