> ## 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 pour [PIXBeginCapture](/fr-CA/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

Nom du fichier de la capture sur la console.

*MaximumToolingMemorySizeMb*\
Type : UINT32

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

*CaptureStorage*\
Type : PIXCaptureStorage

Mode de capture.  Lorsque la valeur est *Memory*, `PIXBeginCapture` remplit la mémoire des outils mise à disposition, puis ignore toutes les nouvelles données qui arrivent.  Lorsque la valeur est *MemoryCircular*, `PIXBeginCapture` utilise la mémoire des outils comme 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 éliminées pour faire place aux nouvelles données.

*CaptureGpuTiming*\
Type : BOOL

Détermine s'il faut capturer ou non les données de minutage du GPU, y compris les événements GPU de PIX, le travail du GPU, les marqueurs GPU de 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 les échantillons du CPU.

*CpuSamplesPerSecond*\
Type : UINT32

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-CA/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-CA/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-CA/reference/tools/pix3/functions/pixbegincapture)\
[PIX (rubrique sous NDA)](/fr-CA/tools/tools-console/pix/pix)\
[pix3](/fr-CA/reference/tools/pix3/pix3_members)


## Related topics

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