PIXSetMarker overview
특정 사용자 정의 이벤트가 발생할 때 PIX System Timing Capture 창의 GPU 타임라인에 마커를 삽입합니다.Syntax
Parameters
contextType: void* 이벤트의 컨텍스트로, ID3D12GraphicsCommandList*, ID3D12CommandQueue* 및 ID3D12XboxDmaCommandList*(XBOX 전용)를 허용합니다. color
Type: UINT64 PIX 창에서 이 이벤트가 발생할 때 타이밍 차트에 사용될 색상입니다. 색상을 지정하려면 PIX_COLOR을 사용하고, 색상 인덱스를 지정하려면 PIX_COLOR_INDEX를 사용하거나, 형식이 ARGB이고 알파 채널 값이 0xff이어야 함에 유의하여 원시 DWORD 값을 전달합니다. formatString _In_
Type: PCWSTR 이벤트를 설명하는 데 사용할 이름으로, null로 종료되는 유니코드 문자열에 대한 포인터입니다. 문자열에는 sprintf 형식과 매우 유사한 선택적 문자열 형식 자리 표시자를 0개 이상 지정할 수 있습니다. Type: … formatString에 자리 표시자가 사용된 경우, 자리 표시자의 형식과 일치하는 형식의 매개 변수를 그에 상응하는 개수(최대 16개)만큼 지정해야 합니다.
Return value
Type: voidRemarks
PIXSetMarker 함수는 런타임에 문자열을 형식화하는 대신 형식 문자열과 형식 매개 변수를 저장합니다. 그런 다음 PIX에서 캡처 파일을 읽을 때 형식화가 수행됩니다. 최상의 성능을 얻으려면 PIXSetMarker에 16바이트로 정렬된 문자열(권장) 또는 8바이트로 정렬된 문자열을 사용합니다. %p 형식 지정자를 사용하여 char* 또는 wchar_t를 포인터로 인쇄하려면, PIXSetMarker에 전달할 때 포인터를 void 또는 정수형이나 부동 소수점 형식에 대한 포인터로 캐스팅합니다. PIXSetMarker에 대한 모든 호출에는 레코드 데이터를 저장할 수 있도록 최소 512바이트의 공간이 보장됩니다.
이벤트는 지속 시간이 없는 것으로 표시되며, PIX System Timing Capture 창에서 단일 선(단일 세로 막대)으로 표현됩니다.
이 함수는 GPU 타임라인의 이벤트를 표시하는 데 사용됩니다. CPU 타임라인의 이벤트를 표시하려면 PIXSetMarker 함수의 첫 번째 오버로드 또는 PIXSetMarker 함수의 두 번째 오버로드를 호출하세요.
PIXSetMarker 호출은 어디에서나 발생할 수 있으며 PIXBeginEvent 호출을 따를 필요는 없습니다.
Requirements
Header: pix3.h Library: pixevt.lib Supported platforms: XBOX One 계열 콘솔 및 XBOX Series 콘솔See also
PIX overview (NDA topic)pix3
PIXSetMarker
PIXSetMarker_2
PIXSetMarker_3
PIXBeginEvent