PIXScopedEvent 함수
PIX(Performance Investigator for Xbox)의 타이밍 캡처 기능에 표시할, CPU 활동의 타이밍 캡처를 위한 사용자 정의 이벤트를 만듭니다.
구문
void PIXScopedEvent(
UINT64 color,
_In_ PCSTR formatString,
...
)
매개 변수
color
형식: UINT64
타임라인 차트에 사용할 이벤트 색상입니다.
PIX_COLOR 상수를 지정하여 미리 정의된 색상을 사용하거나, PIX_COLOR_INDEX 상수를 사용하여 색상 색인을 사용하거나, ARGB 형식의 DWORD 값을 지정하여 사용자 지정 색상을 사용합니다. ARGB 형식의 DWORD 값을 지정하는 경우 해당 값의 알파 채널을 0xff(으)로 설정해야 합니다.
formatString _In_
형식: PCWSTR
null로 끝나는 유니코드 문자열에 대한 포인터로 이벤트를 기술하기 위해 사용할 이름입니다. 문자열은 sprintf 형식과 비슷하게, 0개 이상의 선택적인 문자열 형식의 자리 표시자를 지정할 수 있습니다. 이 메서드는 최대 16개의 자리 표시자를 지원합니다.
형식: ...
formatString에 자리 표시자를 지정한 경우 이 매개 변수에 해당 값 수를 지정해야 합니다. 이 매개 변수에 지정하는 값 형식은 해당 자리 표시자에서 식별된 형식에 따라 달라집니다.
반환 값
형식: void
없음.
비고
이 함수는 PIX의 타이밍 캡처 기능에 표시할, CPU 활동의 타이밍 캡처를 위한 사용자 정의 이벤트를 만듭니다.
PIXScopedEvent(으)로 생성된 이벤트는 API가 호출된 범위가 종료될 때 자동으로 끝나므로, 이벤트의 시작 및 끝에 대한 일치가 자동으로 수행되게 만듭니다.
PIXScopedEvent 함수는 런타임에 문자열 형식을 지정하는 대신 형식 문자열과 형식 매개 변수를 저장합니다. 그런 다음, PIX에서 캡처 파일을 읽을 때 형식이 지정됩니다. 최적의 성능을 얻으려면 PIXScopedEvent과(와) 함께 16바이트 맞춤 문자열(기본) 또는 8바이트 맞춤 문자열을 사용합니다.
%p 형식 지정자를 사용하여 char\* 또는 wchar_t\*의 형식을 포인터로 지정하려면 포인터를 PIXScopedEvent에 전달할 때 void\* 또는 정수나 부동 소수점 형식으로 포인터를 캐스트합니다.
PIXScopedEvent 호출은 녹화 데이터 저장을 위해 최소 512바이트 이상의 공간이 보장되며, 여기에는 형식 문자열 및 모든 변수의 전체 크기 및 맞춤이 포함됩니다. 일반적으로 PIX 이벤트는 게임의 주요 구성 요소, 시스템 또는 콘텐츠에 맞춰진 단기 고성능 마커용으로 사용됩니다.
요구 사항
헤더: pix3.h
라이브러리: pixevt.lib
지원되는 플랫폼: Xbox One 패밀리 콘솔 및 Xbox Series 콘솔