다음을 통해 공유

PIXSetMarker 개요

  • 아티클

특정 사용자 정의 이벤트가 발생할 때 PIX 시스템 타이밍 캡처 창에서 GPU 타임라인에 마커를 삽입합니다.

구문

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

매개 변수

context   
형식: void*

이벤트에 대한 컨텍스트입니다. ID3D12GraphicsCommandList* , ID3D12CommandQueue* 및 ID3D12XboxDmaCommandList*(Xbox만 해당)를 허용합니다.

color   
형식: UINT64

PIX 창에서 이 이벤트가 발생할 때 타이밍 차트에 사용되는 색상입니다.

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

formatString _In_
형식: PCWSTR

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

형식: ...

자리 표시자가 formatString에 사용된 경우 유형이 자리 표시자와 일치하는 해당 매개 변수 수(최대 16개)가 있어야 합니다.

반환 값

형식: void

비고

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

이벤트는 기간을 포함하지 않는 것으로 표시되며, PIX 시스템 타이밍 캡처 창에서 단일 줄(단일 세로 막대)로 표시됩니다.

이 함수는 GPU 타임라인에서 이벤트 표시를 위해 사용됩니다. CPU 타임라인에서 이벤트를 표시하려면 PIXSetMarker 함수의 첫 번째 오버로드 또는 PIXSetMarker 함수의 두 번째 오버로드를 호출합니다.

PIXBeginEvent에 관한 호출은 어디에서나 발생할 수 있으며, PIXSetMarker 호출 뒤에 수행될 필요가 없습니다.

요건

헤더: pix3.h

라이브러리: pixevt.lib

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

참고 항목

PIX 개요(NDA 항목)
pix3
PIXSetMarker
PIXSetMarker_2
PIXSetMarker_3
PIXBeginEvent