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