PIXBeginRetailEvent
사용자 정의 retail 이벤트를 시작합니다.Syntax
Parameters
contextType: void* 이벤트의 컨텍스트로,
ID3D12GraphicsCommandList\*, ID3D12GraphicsCommandList\* 및 ID3D12XboxDmaCommandList\*(XBOX 전용)를 허용합니다.
color Type: UINT64 시스템 타이밍 차트에 사용할 이벤트 색상입니다. 색상을 지정하려면 PIX_COLOR을 사용하고, 색상 인덱스를 지정하려면 PIX_COLOR_INDEX를 사용하거나, 형식이 ARGB이고 알파 채널 값이 0xff이어야 함에 유의하여 원시 DWORD 값을 전달합니다.
formatString _In_
Type: PCWSTR 이벤트를 설명하는 데 사용할 이름으로, null로 종료되는 유니코드 문자열에 대한 포인터입니다. 문자열에는
sprintf 형식과 매우 유사한 선택적 문자열 형식 자리 표시자를 0개 이상 지정할 수 있습니다.
Type: …
formatString에 자리 표시자가 사용된 경우, 그에 상응하는 개수의 매개 변수가 있어야 하며 그 형식은 자리 표시자에 따라 다릅니다. 이 메서드는 최대 16개의 형식 매개 변수를 지원합니다.
Return value
Type: voidRemarks
디버그 또는 계측된 디바이스에서PIXBeginRetailEvent는 PIXBeginEvent와 동일하게 동작합니다. retail 디바이스의 경우 GPU 중단 디버깅을 위해 이벤트가 HIX 파일에 포함됩니다.
PIXBeginRetailEvent와 PIXEndRetailEvent 쌍은 원하는 깊이만큼 중첩할 수 있습니다.
Requirements
Header: pix3.h Library: pixevt.lib Supported platforms: XBOX One 계열 콘솔 및 XBOX Series 콘솔See also
PIX (NDA topic)pix3
PIXEndRetailEvent
PIXBeginRetailEvent(void*, UINT64, PCSTR, …)