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
