跳轉到主要內容

PIXSetMarker 參考

當特定使用者定義的事件發生時,在 PIX System Timing Capture 視窗的 CPU 時間軸中插入標記。

語法

參數

color   
類型:UINT64
此事件在 PIX 視窗中發生時,計時圖表中將使用的色彩。 使用 PIX_COLOR 指定色彩、使用 PIX_COLOR_INDEX 指定色彩索引,或傳入原始 DWORD (請注意格式為 ARGB,且 Alpha 色板值必須為 0xff)。 formatString   _In_
類型:PCWSTR
用來描述事件的名稱,為以 Null 結束之 Unicode 字串的指標。此字串可以指定零個或多個選擇性的字串格式預留位置,與 sprintf 格式非常類似。 類型:… 如果在 formatString 中使用了預留位置,則必須有對應數目的參數 (最多 16 個),且其類型必須與預留位置相符。

傳回值

類型:void

備註

PIXSetMarker 函式會儲存格式字串和格式參數,而不是在執行階段格式化字串。格式化會在 PIX 中讀取擷取檔案時進行。搭配 PIXSetMarker 使用 16 位元組對齊的字串 (建議) 或 8 位元組對齊的字串,以獲得最佳效能。若要使用 %p 格式規範將 char* 或 wchar_t* 列印為指標,請在將指標傳遞給 PIXSetMarker 時,將其轉換為 void* 或整數或浮點類型的指標。任何對 PIXSetMarker 的呼叫都保證至少有 512 位元組的空間來儲存記錄資料。 事件會顯示為沒有持續時間,並在 PIX System Timing Capture 視窗中以單一線條 (單一垂直線) 表示。 此函式用於標記 CPU 時間軸中的事件。若要標記 GPU 時間軸中的事件,請呼叫 PIXSetMarker 函式的第三個多載或 PIXSetMarker 函式的第四個多載 對 PIXSetMarker 的呼叫可以在任何位置發生,不必在 PIXBeginEvent 呼叫之後。

需求

標頭: pix3.h 程式庫: pixevt.lib 支援的平台: XBOX One 系列主機和 XBOX Series 主機

另請參閱

PIX 概觀 (NDA 主題)
pix3
PIXSetMarker
PIXSetMarker_3
PIXSetMarker_4
最後修改於 2026年10月6日