다음을 통해 공유

PIXSetRetailMarker 함수

  • 아티클

특정 사용자 정의 이벤트가 발생할 때 소매 마커를 삽입합니다.

구문

void PIXSetRetailMarker(  
         void* context,  
         UINT64 color,  
         PCSTR formatString,  
         ...  
)

매개 변수

context   
형식: void*

이벤트에 관한 컨텍스트입니다. 1ID3D12GraphicsCommandList*,ID3D12CommandQueue*andID3D12XboxDmaCommandList*`(Xbox만 해당)를 허용합니다.

color   
형식: UINT64

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

formatString _In_
형식: PCSTR

이벤트를 설명하기 위해 사용할 이름입니다. 문자열은 sprintf 형식과 비슷하게, 0개 이상의 선택적인 문자열 형식의 자리 표시자를 지정할 수 있습니다.

형식: ...

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

반환 값

형식: void

설명

디버그나 계측 디바이스를 사용하면 PIXSetRetailMarker은(는) PIXSetMarker와 동일하게 작동합니다. 소매 디바이스의 경우 마커는 GPU 중단 디버깅에 관한 HIX 파일에 포함됩니다.

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

요구 사항

헤더: pix3.h

라이브러리: pixevt.lib 지원되는 플랫폼:Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

PIXSetRetailMarker(void*, UINT64, PCWSTR, ...)
pix3
PIX(NDA 항목)