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

Parâmetros para [PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture).

## Sintaxe

```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;
```

### Membros

*FileName*\
Tipo: PWSTR

O nome do arquivo da captura no console.

*MaximumToolingMemorySizeMb*\
Tipo: UINT32

O tamanho máximo, em MB, do buffer na memória de ferramentas que será usado para armazenar os dados de captura.\
A captura será interrompida quando o buffer de memória estiver cheio ou usará a memória de ferramentas como um buffer circular, dependendo do valor de *CaptureStorage*.

*CaptureStorage*\
Tipo: PIXCaptureStorage

O modo de captura.  Quando definido como *Memory*, `PIXBeginCapture` preencherá a memória de ferramentas disponibilizada e, em seguida, descartará todos os novos dados recebidos.  Quando definido como *MemoryCircular*, `PIXBeginCapture` usará a memória de ferramentas como um buffer circular.  A captura será executada até que a memória de ferramentas esteja cheia, mas, em vez de interromper a captura, os dados mais antigos serão descartados para abrir espaço para novos dados.

*CaptureGpuTiming*\
Tipo: BOOL

Determina se os dados de tempo da GPU devem ser capturados, incluindo eventos de GPU do PIX, trabalho da GPU, marcadores de GPU do PIX e marcadores de API.

*CaptureCallstacks*\
Tipo: BOOL

Determina se as pilhas de chamadas devem ser capturadas para trocas de contexto.

*CaptureCpuSamples*\
Tipo: BOOL

Determina se as amostras da CPU devem ser capturadas.

*CpuSamplesPerSecond*\
Tipo: UINT32

O número de amostras da CPU por segundo a serem capturadas.

*CaptureFileIO*\
Tipo: BOOL

Determina se a E/S de arquivo do DirectStorage e do Win32 deve ser capturada.

*CaptureVirtualAllocEvents*\
Tipo: BOOL

Determina se os eventos de alocação virtual devem ser capturados.

*CaptureHeapAllocEvents*\
Tipo: BOOL

Determina se os eventos de alocação de heap devem ser capturados.

*CaptureXMemEvents*\
Tipo: BOOL

Determina se os eventos de alocação XMem devem ser capturados.

*CapturePixMemEvents*\
Tipo: BOOL

Determina se as alocações feitas com alocadores de memória personalizados definidos pelo título devem ser capturadas.

*CapturePageFaultEvents*\
Tipo: BOOL

Determina se os eventos de falha de página devem ser capturados.

*CaptureVideoFrames*\
Tipo: BOOL

Determina se os quadros de vídeo devem ser capturados.

## Comentários

Esta união é usada por [PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture) para iniciar uma captura de tempo do PIX controlada programaticamente.

`PixBeginCapture` também usa os sinalizadores retornados por [PixGetCaptureState](/pt-BR/reference/tools/pix3/functions/pixgetcapturestate).

## Requisitos

**Cabeçalho:** pix3.h

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture)\
[PIX (tópico sob NDA)](/pt-BR/tools/tools-console/pix/pix)\
[pix3](/pt-BR/reference/tools/pix3/pix3_members)


## Related topics

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