다음을 통해 공유

PIXBeginEvent 개요

  • 아티클

PIX의 시스템 타이밍 캡처 기능에 표시할 CPU 활동의 타이밍 캡처를 위한 사용자 정의 이벤트를 시작합니다.

구문

void PIXBeginEvent(  
         void* context,  
         UINT64 color,  
         PCWSTR formatString,
         ...  
)

매개 변수

context   
형식: void*

이벤트에 관한 컨텍스트입니다. ID3D12GraphicsCommandList\*, ID3D12GraphicsCommandList\* 및 ID3D12XboxDmaCommandList\*(Xbox만 해당)을(를) 받습니다.

color   
형식: UINT64

시스템 타이밍 차트에 사용할 이벤트 색상입니다. PIX_COLOR를 사용하여 색상을 지정하거나, PIX_COLOR_INDEX를 사용하여 색상 인덱스를 지정하거나, 형식이 ARGB이고 알파 채널 값이 0xff여야 함을 나타내는 원시 DWORD를 전달합니다.

formatString _In_
형식: PCWSTR

null로 끝나는 유니코드 문자열에 대한 포인터로 이벤트를 기술하기 위해 사용할 이름입니다. 문자열은 sprintf 형식과 비슷하게, 0개 이상의 선택적인 문자열 형식의 자리 표시자를 지정할 수 있습니다.

형식: ...

자리 표시자가 formatString에 사용된 경우 해당 유형이 자리 표시자에 의존하는 해당 매개 변수 수가 있어야 합니다. 이 메서드는 최대 16개의 형식 매개 변수를 지원합니다.

반환 값

형식: void

비고

PIXBeginEvent 함수는 런타임에 문자열 형식을 지정하는 대신 형식 문자열 및 형식 매개 변수를 저장합니다. 그런 후 PIX에서 캡처 파일을 읽을 때 형식 지정이 수행됩니다. 최상의 성능을 얻기 위해서는 PIXBeginEvent과(와) 함께 16바이트 맞춤 문자열(기본) 또는 8바이트 맞춤 문자열을 사용합니다. %p 형식 지정자를 사용하여 char* 또는 wchar_t*를 포인터로 출력하려면 이를 PIXBeginEvent에 전달할 때 포인터를 void*로 캐스팅하거나 포인터를 정수 또는 부동 소수점 포인트 유형으로 캐스팅합니다. 최상의 성능을 위해 정적으로 할당된 문자열을 사용합니다.

PIXBeginEvent 호출은 녹화 데이터 저장을 위해 최소 512바이트 이상의 공간이 보장되며, 여기에는 형식 문자열 및 모든 변수의 전체 크기 및 맞춤이 포함됩니다. 일반적으로 PIX 이벤트는 게임의 주요 구성 요소, 시스템 또는 콘텐츠에 맞춰진 단기 고성능 마커용으로 사용됩니다.

이 메서드는 CPU 이벤트의 시간을 맞추기 위해 사용됩니다. GPU 이벤트 타이밍에 관한 자세한 내용은 PIX3의 PIX GPU 캡처 API 섹션을 참조하세요.

PIXBeginEvent 호출 시마다 일치하는 PIXEndEvent도 호출해야 합니다. 및 PIXEndEvent에 대한 쌍을 PIXBeginEvent 이루는 호출은 동일한 스레드에서 발생해야 합니다. 타이밍 간격은 약 200ns이고, 이 함수는 사용에 따른 오버헤드가 낮으므로 PIXBeginEvent을(를) 초당 최대 수십만 회까지 호출할 수 있습니다.

PIXBeginEvent 및 PIXEndEvent 쌍은 모든 깊이에 중첩될 수 있습니다.

요구 사항

헤더: pix3.h

라이브러리: pixevt.lib

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

참고 항목

PIX(NDA 항목)
pix3
PIXEndEvent
PIXBeginEvent
PIXBeginEvent_2
PIXBeginEvent_3