PIXBeginEvent 함수
PIX의 시스템 타이밍 캡쳐 기능에 표시할 CPU 활동의 타이밍 캡처를 위한 사용자 정의 이벤트를 시작합니다.
구문
void PIXBeginEvent(
UINT64 color,
PCSTR formatString,
...
)
매개 변수
color
형식: UINT64
시스템 타이밍 차트에 사용할 이벤트 색상입니다. PIX_COLOR를 사용하여 색상을 지정하거나, PIX_COLOR_INDEX를 사용하여 색상 인덱스를 지정하거나, 형식이 ARGB이고 알파 채널 값이 0xff여야 함을 나타내는 원시 DWORD를 전달합니다.
formatString _In_
형식: PCSTR
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_2
PIXBeginEvent_3
PIXBeginEvent_4