> ## 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](/reference/tools/pix3/functions/pixbegincapture).

## Sintaxis

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

### Miembros

*FileName*\
Tipo: PWSTR

El nombre de archivo de la captura en la consola.

*MaximumToolingMemorySizeMb*\
Tipo: UINT32

El número máximo en MB del búfer de la memoria de herramientas que se usará para contener los datos de captura.\
La captura se detendrá cuando el búfer de memoria esté lleno, o bien usará la memoria de herramientas como búfer en anillo, según el valor de *CaptureStorage*.

*CaptureStorage*\
Tipo: PIXCaptureStorage

El modo de captura.  Cuando se establece en *Memory*, `PIXBeginCapture` llenará la memoria de herramientas disponible y, a continuación, descartará los nuevos datos que lleguen.  Cuando se establece en *MemoryCircular*, `PIXBeginCapture` usará la memoria de herramientas como búfer en anillo.  La captura se ejecutará hasta que la memoria de herramientas esté llena, pero en lugar de detener la captura, los datos más antiguos se irán eliminando para dejar espacio a los datos nuevos.

*CaptureGpuTiming*\
Tipo: BOOL

Determina si se capturan o no los datos de tiempos de la GPU, incluidos los eventos de GPU de PIX, el trabajo de la GPU, los marcadores de GPU de PIX y los marcadores de API.

*CaptureCallstacks*\
Tipo: BOOL

Determina si se capturan o no las pilas de llamadas para los cambios de contexto.

*CaptureCpuSamples*\
Tipo: BOOL

Determina si se capturan o no las muestras de CPU.

*CpuSamplesPerSecond*\
Tipo: UINT32

El número de muestras de CPU por segundo que se capturarán.

*CaptureFileIO*\
Tipo: BOOL

Determina si se captura o no la E/S de archivos de DirectStorage y Win32.

*CaptureVirtualAllocEvents*\
Tipo: BOOL

Determina si se capturan o no los eventos de asignación virtual.

*CaptureHeapAllocEvents*\
Tipo: BOOL

Determina si se capturan o no los eventos de asignación del montón.

*CaptureXMemEvents*\
Tipo: BOOL

Determina si se capturan o no los eventos de asignación de XMem.

*CapturePixMemEvents*\
Tipo: BOOL

Determina si se capturan o no las asignaciones realizadas con asignadores de memoria personalizados definidos por el título.

*CapturePageFaultEvents*\
Tipo: BOOL

Determina si se capturan o no los eventos de error de página.

*CaptureVideoFrames*\
Tipo: BOOL

Determina si se capturan o no los fotogramas de vídeo.

## Comentarios

Esta unión la usa [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture) para iniciar una captura de tiempos de PIX controlada mediante programación.

`PixBeginCapture` también usa las marcas devueltas por [PixGetCaptureState](/reference/tools/pix3/functions/pixgetcapturestate).

## Requisitos

**Encabezado:** pix3.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

- [PIX3](/es/reference/tools/pix3/pix3_members.md)
- [XAppCaptureVideoCaptureSettings](/es/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [XAppCapture](/es/reference/system/xappcapture/xappcapture_members.md)
- [PIXEndCapture](/es/reference/tools/pix3/functions/pixendcapture.md)
- [XAppCaptureGetVideoCaptureSettings](/es/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings.md)