PIXBeginCapture

프로그래밍 방식으로 제어되는 PIX 타이밍 캡처를 시작합니다.

구문

HRESULT PIXBeginCapture(  
         DWORD captureFlags,  
         const PPIXCaptureParameters captureParameters  
)  

매개변수

captureFlags
형식: DWORD 수행할 캡처 유형을 나타내는 플래그입니다. 한 번에 하나의 캡처 플래그만 PIXBeginCapture에 전달할 수 있습니다. captureParameters _In_opt_
형식: PPIXCaptureParameters 타이밍 캡처의 경우 TimingCaptureParameters 구조체에 대한 포인터를 전달하거나 TimingCaptureParameters 구조체를 포함하는 PIXCaptureParameters 공용 구조체에 대한 포인터를 전달합니다.

반환값

형식: HRESULT 캡처가 성공적으로 시작되었는지 여부를 나타냅니다. 성공 시 S_FALSE가 반환됩니다. 한 번에 하나의 캡처만 실행할 수 있습니다. 다른 캡처가 현재 실행 중일 때 PIXBeginCapture가 호출되면 E_PENDING이 반환되고 호출은 아무런 효과가 없습니다.

플래그

플래그	값	설명
PIX_CAPTURE_TIMING	(1 << 0)	시스템 타이밍.
PIX_CAPTURE_GPU	(1 << 1)	GPU에 전송된 모든 명령과 그 입력을 캡처하여 재생 및 분석할 수 있도록 합니다.
PIX_CAPTURE_FUNCTION_SUMMARY	(1 << 2)	Home 탭에서 함수 요약 캡처가 시작되었습니다.
PIX_CAPTURE_FUNCTION_DETAILS	(1 << 3)	함수 요약 또는 콜그래프 캡처에서 Capture Additional Calls 버튼을 사용하여 추가 함수 세부 정보에 대한 요청이 시작되었습니다.
PIX_CAPTURE_CALLGRAPH	(1 << 4)	PIX에서 또는 `PIXBeginCapture` 호출을 통해 프로그래밍 방식으로 콜그래프 캡처가 시작되었습니다.
PIX_CAPTURE_INSTRUCTION_TRACE	(1 << 5)	CPU 명령 추적 캡처가 진행 중입니다.
PIX_CAPTURE_SYSTEM_MONITOR_COUNTERS	(1 << 6)	시스템 모니터 카운터.
PIX_CAPTURE_VIDEO	(1 << 7)	비디오 재생.
PIX_CAPTURE_AUDIO	(1 << 8)	오디오 재생.
PIX_CAPTURE_GPU_TRACE	(1 << 9)	GPU Streaming Performance Monitor(SPM) 카운터와 거의 모든 GPU 블록의 Shader Queue Thread Tracing(SQTT) 데이터를 캡처합니다.
PIX_CAPTURE_RESERVED	(1 << 15)	향후 또는 특수한 캡처 시나리오를 위해 PIX가 내부적으로 사용하는 자리 표시자 플래그입니다.

설명

이 함수는 타이틀 코드에서 PIX 캡처를 시작합니다. PIXBeginCapture는 현재 timing capture(NDA 항목)를 수행하는 데에만 사용할 수 있습니다. PIXBeginCapture는 캡처 데이터를 콘솔의 툴링 메모리에 저장합니다. 캡처에 사용할 수 있는 툴링 메모리의 양은 PIXCaptureParameters 구조체에서 MaximumToolingMemorySizeMb 필드를 설정하여 지정합니다. 프로그래밍 방식의 타이밍 캡처는 PIXCaptureParameters 구조체의 PIXCaptureStorage 열거형 값으로 정의된 두 가지 모드 중 하나로 수행할 수 있습니다. PIXCaptureStorage가 Memory로 설정되면 PIXBeginCapture는 사용 가능한 툴링 메모리를 채운 다음 들어오는 새 데이터를 폐기합니다. PIXCaptureStorage가 MemoryCircular로 설정되면 PIXBeginCapture는 툴링 메모리를 링 버퍼로 사용합니다. 캡처는 툴링 메모리가 가득 찰 때까지 실행되지만, 캡처를 중단하지 않고 가장 오래된 데이터를 만료시켜 새 데이터를 위한 공간을 만듭니다. 캡처는 계속 실행됩니다. MemoryCircular 캡처는 콘솔에서 사용 가능한 툴링 메모리를 소진하지 않으면서 장시간 실행되도록 설계되었습니다. PIXBeginCapture를 사용하여 수행한 타이밍 캡처는 PIX에서 볼 수 있도록 PC로 다시 복사하여 .xpix 파일로 변환해야 합니다. PIX에서 프로그래밍 방식의 캡처를 보기 위해 필요한 단계에 대한 설명은 Opening Programmatic Timing Captures(NDA 항목)를 참조하십시오. 타이틀 코드에서 PIX 캡처를 중지하려면 PIXEndCapture를 사용합니다.

//
//  timing capture
//
PIXCaptureParameters captureParams = {};

captureParams.TimingCaptureParameters.CaptureGpuTiming = TRUE;
captureParams.TimingCaptureParameters.CaptureCallstacks = TRUE;
captureParams.TimingCaptureParameters.CaptureCpuSamples = TRUE;
captureParams.TimingCaptureParameters.CpuSamplesPerSecond = 4000;

captureParams.TimingCaptureParameters.CaptureStorage = PIXCaptureParameters::Memory;
captureParams.TimingCaptureParameters.FileName = wstrFilename;
captureParams.TimingCaptureParameters.MaximumToolingMemorySizeMb = 4096;

XSF_ERROR_IF_FAILED(PIXBeginCapture(PIX_CAPTURE_TIMING, &captureParams));

요구 사항

헤더: pix3.h 라이브러리: pixevt.lib 지원되는 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 문서

Analyzing CPU performance (contents)

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

PIXBeginCapture

PIXBeginCapture

구문

매개변수

반환값

플래그

설명

요구 사항

개념 문서

함께 보기

​PIXBeginCapture

​구문

​매개변수

​반환값

​플래그

​설명

​요구 사항

​개념 문서

​함께 보기

PIXBeginCapture

구문

매개변수

반환값

플래그

설명

요구 사항

개념 문서

함께 보기