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

[PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture)의 매개 변수입니다.

## Syntax

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

### Members

*FileName*\
Type: PWSTR

콘솔의 캡처에 대한 파일 이름입니다.

*MaximumToolingMemorySizeMb*\
Type: UINT32

캡처 데이터를 보관하는 데 사용되는 툴링 메모리의 버퍼 최대 크기(MB)입니다.\
*CaptureStorage*의 값에 따라 메모리 버퍼가 가득 차면 캡처가 중지되거나 툴링 메모리를 링 버퍼로 사용합니다.

*CaptureStorage*\
Type: PIXCaptureStorage

캡처 모드입니다. *Memory*로 설정하면 `PIXBeginCapture`는 사용 가능한 툴링 메모리를 채운 다음 들어오는 새 데이터를 모두 폐기합니다. *MemoryCircular*로 설정하면 `PIXBeginCapture`는 툴링 메모리를 링 버퍼로 사용합니다. 캡처는 툴링 메모리가 가득 찰 때까지 실행되지만 캡처를 중지하는 대신 가장 오래된 데이터가 밀려나면서 새 데이터를 위한 공간을 만듭니다.

*CaptureGpuTiming*\
Type: BOOL

PIX GPU 이벤트, GPU 작업, PIX GPU 마커 및 API 마커를 포함한 GPU 타이밍 데이터를 캡처할지 여부를 결정합니다.

*CaptureCallstacks*\
Type: BOOL

컨텍스트 전환에 대한 호출 스택을 캡처할지 여부를 결정합니다.

*CaptureCpuSamples*\
Type: BOOL

CPU 샘플을 캡처할지 여부를 결정합니다.

*CpuSamplesPerSecond*\
Type: UINT32

초당 캡처할 CPU 샘플 수입니다.

*CaptureFileIO*\
Type: BOOL

DirectStorage 및 Win32 파일 IO를 캡처할지 여부를 결정합니다.

*CaptureVirtualAllocEvents*\
Type: BOOL

가상 할당 이벤트를 캡처할지 여부를 결정합니다.

*CaptureHeapAllocEvents*\
Type: BOOL

힙 할당 이벤트를 캡처할지 여부를 결정합니다.

*CaptureXMemEvents*\
Type: BOOL

XMem 할당 이벤트를 캡처할지 여부를 결정합니다.

*CapturePixMemEvents*\
Type: BOOL

타이틀에서 정의한 사용자 지정 메모리 할당자로 이루어진 할당을 캡처할지 여부를 결정합니다.

*CapturePageFaultEvents*\
Type: BOOL

페이지 폴트 이벤트를 캡처할지 여부를 결정합니다.

*CaptureVideoFrames*\
Type: BOOL

비디오 프레임을 캡처할지 여부를 결정합니다.

## Remarks

이 union은 [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture)에서 프로그래밍 방식으로 제어되는 PIX 타이밍 캡처를 시작하는 데 사용됩니다.

`PixBeginCapture`는 또한 [PixGetCaptureState](/reference/tools/pix3/functions/pixgetcapturestate)에서 반환된 플래그를 사용합니다.

## Requirements

**Header:** pix3.h

**Supported platforms:** XBOX One 계열 콘솔 및 XBOX Series 콘솔

## See also

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