다음을 통해 공유

PIXBeginRetailEvent

  • 아티클

사용자 정의 소매 이벤트를 시작합니다.

구문

void PIXBeginRetailEvent(  
         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

설명

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

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

요구 사항

헤더: pix3.h

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

참고 항목

PIX(NDA 항목)
pix3
PIXEndRetailEvent
PIXBeginRetailEvent(void*, UINT64, PCSTR, ...)