다음을 통해 공유

PIXCaptureParameters

  • 아티클

PIXBeginCapture의 매개 변수입니다.

구문

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;

멤버

FileName
형식: PWSTR

본체의 캡처에 대한 파일 이름입니다.

MaximumToolingMemorySizeMb
형식: UINT32

캡처 데이터를 보유하는 데 사용될 도구 메모리의 최대 버퍼 수(MB)입니다.
메모리 버퍼가 가득 차면 캡처가 중지되거나 CaptureStorage 값에 따라 도구 메모리를 링 버퍼로 사용합니다.

CaptureStorage
형식: PIXCaptureStorage

캡처 모드입니다. 메모리PIXBeginCapture로 설정하면 사용 가능한 도구 메모리가 채워진 후 새로 들어오는 데이터는 모두 삭제됩니다. MemoryCircular로 설정하면 PIXBeginCapture이(가) 도구 메모리를 링 버퍼로 사용합니다. 캡처는 도구 메모리가 가득 찰 때까지 실행되지만 캡처를 중지하는 대신 가장 오래된 데이터를 없애 새 데이터를 위한 공간을 확보합니다.

CaptureGpuTiming
형식: BOOL

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

CaptureCallstacks
형식: BOOL

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

CaptureCpuSamples
형식: BOOL

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

CpuSamplesPerSecond
형식: UINT32

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

CaptureFileIO
형식: BOOL

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

CaptureVirtualAllocEvents
형식: BOOL

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

CaptureHeapAllocEvents
형식: BOOL

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

CaptureXMemEvents
형식: BOOL

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

CapturePixMemEvents
형식: BOOL

타이틀 정의 사용자 지정 메모리 할당자를 사용하여 만든 할당을 캡처할지 여부를 결정합니다.

CapturePageFaultEvents
형식: BOOL

페이지 오류 이벤트의 캡처 여부를 결정합니다.

CaptureVideoFrames
형식: BOOL

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

설명

이 통합은 PIXBeginCapture에서 프로그래밍 방식으로 제어되는 PIX 타이밍 캡처를 시작하는 데 사용됩니다.

또한 PixBeginCapture은(는) PixGetCaptureState에서 반환되는 플래그도 사용합니다.

요구 사항

헤더: pix3.h

지원되는 플랫폼: Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

PIXBeginCapture
PIX(NDA 항목)
pix3