C++ Build Insights SDK 與 Visual Studio 2017 和更新版本相容。 若要查看這些版本的文件,請將本文的 Visual Studio 版本選取器控制項設定為 Visual Studio 2017 或更新版本。 其位於此頁面目錄頂端。
編譯程式事件
編譯器
指令行
ENVIRONMENT_VARIABLE
FILE_INPUT
OBJ_OUTPUT
前端通過
後端通行證
編譯程式前端事件
C1_DLL
前端檔案
模板實例化
SYMBOL_NAME
模組
HEADER_UNIT
PRECOMPILED_HEADER
編譯程式後端事件
C2_DLL
整體程式分析
自上而下
由下而上
CODE_GENERATION
線
功能
FORCE_INLINEE
連結器事件
連結器
指令行
ENVIRONMENT_VARIABLE
FILE_INPUT
可執行影像輸出
EXP_OUTPUT
IMP_LIB_OUTPUT
LIB_OUTPUT
PASS1
PRE_LTCG_OPT_REF
LTCG
OPT_REF
OPT_ICF
OPT_LBR
PASS2
事件資料表
| 活動 | 屬性 | 說明 |
|---|---|---|
| 後端通行証 | 類型 | 活動 |
| 父項 | 編譯器 | |
| 孩子 | C2_DLL | |
| 屬性 | - 輸入來源檔案的絕對路徑 - 輸出物件檔的絕對路徑 |
|
| 擷取類別 |
活動 CompilerPass BackEndPass |
|
| 說明 | 發生在編譯程式後端傳遞的啟動和停止。 此流程負責優化已剖析的 C/C++ 原始程式碼,並將其轉換為機器碼。 | |
| 自下而上 | 類型 | 活動 |
| 父項 | 整體程式分析 | |
| 孩子 | 無 | |
| 屬性 | 無 | |
| 擷取類別 |
活動 自底向上 |
|
| 說明 | 發生在整個程式分析的下移階段的開始和停止。 | |
| C1_DLL | 類型 | 活動 |
| 父項 | 前端通過 | |
| 孩子 |
前端檔案 SYMBOL_NAME 模板實例化 |
|
| 屬性 | 無 | |
| 擷取類別 |
活動 C1DLL |
|
| 說明 | 發生於c1.dll或c1xx.dll的調用開始和停止時。 這些 DLL 是編譯程式的 C 和 C++ 前端。 它們只由編譯程式驅動程式叫用(cl.exe)。 | |
| C2_DLL | 類型 | 活動 |
| 父項 |
後端通行證 LTCG |
|
| 孩子 |
CODE_GENERATION 整體程式分析 |
|
| 屬性 | 無 | |
| 擷取類別 |
活動 C2DLL |
|
| 說明 | 在啟動和停止c2.dll調用時發生。 此 DLL 是編譯程式的後端。 編譯程式驅動程式會呼叫它(cl.exe)。 連結器(link.exe)在使用連結時間程式碼產生時也會叫用它。 | |
| 代碼生成 | 類型 | 活動 |
| 父項 | C2_DLL | |
| 孩子 |
功能 線 |
|
| 屬性 | 無 | |
| 擷取類別 |
活動 CodeGeneration |
|
| 說明 | 發生在後端程式代碼產生階段的開始和停止。 | |
| 命令列 | 類型 | 簡單事件 |
| 父項 |
編譯器 連結器 |
|
| 孩子 | 無 | |
| 屬性 | - 用來執行 cl.exe 或 link.exe 的命令列 | |
| 擷取類別 |
SimpleEvent CommandLine |
|
| 說明 | 在編譯程式和連結器完成評估命令行時發生。 評估的命令行包含透過回應檔傳遞的所有 cl.exe 和 link.exe 參數。 它也包含透過 CL、_CL_、LINK 和 _LINK_等環境變數傳遞cl.exe和link.exe的參數。 | |
| 編譯器 | 類型 | 活動 |
| 父項 | 無 | |
| 孩子 |
後端通行證 指令行 ENVIRONMENT_VARIABLE FILE_INPUT OBJ_OUTPUT 前端通過 |
|
| 屬性 | - 編譯程式版本 - 工作目錄 - 調用的 cl.exe 的絕對路徑 |
|
| 擷取類別 |
活動 調用 編譯器 |
|
| 說明 | 發生在 cl.exe 調用 的開始和停止。 | |
| 環境變數 | 類型 | 簡單事件 |
| 父項 |
編譯器 連結器 |
|
| 孩子 | 無 | |
| 屬性 | - 環境變數的名稱 - 環境變數的值。 |
|
| 擷取類別 |
SimpleEvent 環境變數 |
|
| 說明 | 每當叫用 cl.exe 或 link.exe 時,現有的每個環境變數都會發生一次。 | |
| 可執行檔_圖片_輸出 | 類型 | 簡單事件 |
| 父項 | 連結器 | |
| 孩子 | 無 | |
| 屬性 | - DLL 或可執行文件輸出檔的絕對路徑。 | |
| 擷取類別 |
SimpleEvent FileOutput 可執行圖像輸出 |
|
| 說明 | 當其中一個連結器輸入是 DLL 或可執行圖像檔時發生。 | |
| EXP_OUTPUT | 類型 | 簡單事件 |
| 父項 | 連結器 | |
| 孩子 | 無 | |
| 屬性 | - .exp 輸出檔的絕對路徑。 | |
| 擷取類別 |
SimpleEvent FileOutput ExpOutput |
|
| 說明 | 當其中一個 連結器輸出是 .exp 檔案時發生。 | |
| 檔案輸入 | 類型 | 簡單事件 |
| 父項 |
編譯器 連結器 |
|
| 孩子 | 無 | |
| 屬性 | - 輸入檔的絕對路徑 - 輸入檔的類型 |
|
| 擷取類別 |
SimpleEvent FileInput |
|
| 說明 | 當發生時會指出 cl.exe 或 link.exe 的輸入。 | |
| FORCE_INLINEE | 類型 | 簡單事件 |
| 父項 | 功能 | |
| 孩子 | 無 | |
| 屬性 | - 強制內嵌函式的名稱。 - 強制內嵌函式的大小,以中繼指令計數表示。 |
|
| 擷取類別 |
活動 ForceInlinee |
|
| 說明 | 發生於使用 __forceinline 關鍵詞將一個函式強制內嵌至另一個函式時。 |
|
| FRONT_END_FILE | 類型 | 活動 |
| 父項 |
C1_DLL 前端檔案 |
|
| 孩子 |
前端檔案 模板實例化 |
|
| 屬性 | - 檔案的絕對路徑。 | |
| 擷取類別 |
活動 FrontEndFile |
|
| 說明 | 當編譯程式前端啟動並停止處理檔案時發生。 這個事件是遞歸的。 當前端解析包含的檔案時,會出現遞迴。 | |
| 前端處理階段 | 類型 | 活動 |
| 父項 | 編譯器 | |
| 孩子 |
C1_DLL 模組 HEADER_UNIT PRECOMPILED_HEADER |
|
| 屬性 | - 輸入來源檔案的絕對路徑 - 輸出物件檔的絕對路徑 |
|
| 擷取類別 |
活動 CompilerPass FrontEndPass |
|
| 說明 | 發生在編譯程式前端傳遞的啟動和停止。 此過程負責剖析 C/C++ 原始程式碼,並將其轉換為中間語言。 | |
| 功能 | 類型 | 活動 |
| 父項 |
CODE_GENERATION 線 自上而下 |
|
| 孩子 | FORCE_INLINEE | |
| 屬性 | - 函式的名稱 | |
| 擷取類別 |
活動 功能 |
|
| 說明 | 在開始和結束生成函式程式碼時會發生。 | |
| HEADER_UNIT | 類型 | 活動 |
| 父物件 | 前端通過 | |
| 孩子 | 無 | |
| 屬性 | 無 | |
| 擷取類別 |
SimpleEvent TranslationUnitType HeaderUnit |
|
| 說明 | 發生在前端階段的開頭,並表示正在處理標頭單元轉譯單元。 | |
| IMP_LIB_OUTPUT | 類型 | 簡單事件 |
| 父層 | 連結器 | |
| 孩子 | 無 | |
| 屬性 | - 匯入庫輸出檔的絕對路徑。 | |
| 擷取類別 |
SimpleEvent FileOutput ImpLibOutput |
|
| 說明 | 發生當其中一個連結器的輸出是匯入庫時。 | |
| LIB_OUTPUT | 類型 | 簡單事件 |
| 家長 | 連結器 | |
| 孩子 | 無 | |
| 屬性 | - 靜態庫輸出檔的絕對路徑。 | |
| 擷取類別 |
SimpleEvent FileOutput LibOutput |
|
| 說明 | 當其中一個連結器輸出是靜態庫時發生。 | |
| 連結器 | 類型 | 活動 |
| 父母 | 無 | |
| 孩子 |
指令行 ENVIRONMENT_VARIABLE 可執行影像輸出 EXP_OUTPUT FILE_INPUT IMP_LIB_OUTPUT LIB_OUTPUT PASS1 PASS2 |
|
| 屬性 | - 鏈接器版本 - 工作目錄 - 被呼叫的 link.exe 絕對路徑 |
|
| 擷取類別 |
活動 調用 連結器 |
|
| 說明 | 在link.exe執行的開始和結束時發生。 | |
| LTCG | 類型 | 活動 |
| 父項 | PASS1 | |
| 孩子 | C2_DLL | |
| 屬性 | 無 | |
| 擷取類別 |
活動 LTCG |
|
| 說明 | 發生在連結時間程式碼生成的開始和結束時。 | |
| 模組 | 類型 | 活動 |
| 父項 | 前端通過 | |
| 孩子 | 無 | |
| 屬性 | 無 | |
| 擷取類別 |
SimpleEvent TranslationUnitType 模組 |
|
| 說明 | 發生在前端階段的開頭,並表示正在處理模組轉譯單位。 | |
| OBJ_OUTPUT | 類型 | 簡單事件 |
| 父項 | 編譯器 | |
| 孩子 | 無 | |
| 屬性 | - .obj輸出檔案的絕對路徑 | |
| 擷取類別 |
SimpleEvent FileOutput ObjOutput |
|
| 說明 | 針對每個由cl.exe產生的.obj輸出,會發生一次。 | |
| OPT_ICF | 類型 | 活動 |
| 父項 | PASS1 | |
| 孩子 | 無 | |
| 屬性 | 無 | |
| 擷取類別 |
活動 OptICF |
|
| 說明 | 在相同 COMDAT 折疊 (/OPT:ICF) 連結器優化的開始和結束時發生。 | |
| OPT_LBR | 類型 | 活動 |
| 父項 | PASS1 | |
| 孩子 | 無 | |
| 屬性 | 無 | |
| 擷取類別 |
活動 OptLBR |
|
| 說明 | 發生在長分支(/OPT:LBR)鏈接器優化的開始和停止。 | |
| OPT_REF | 類型 | 活動 |
| 父項 | PASS1 | |
| 孩子 | 無 | |
| 屬性 | 無 | |
| 擷取類別 |
活動 OptRef |
|
| 說明 | 發生於未參考函式的開始和停止,以及數據消除 (/OPT:REF) 連結器優化。 | |
| 第一階段 | 類型 | 活動 |
| 父項 | 連結器 | |
| 孩子 |
LTCG OPT_ICF OPT_LBR OPT_REF |
|
| 屬性 | 無 | |
| 擷取類別 |
活動 Pass1 |
|
| 說明 | 發生在連結器傳遞 1 的開始和停止。 | |
| PASS2 | 類型 | 活動 |
| 父項 | 連結器 | |
| 孩子 | 無 | |
| 屬性 | 無 | |
| 擷取類別 |
活動 Pass2 |
|
| 說明 | 發生在連結器傳遞 2 的開始和停止。 | |
| PRECOMPILED_HEADER | 類型 | 活動 |
| 父項 | 前端通過 | |
| 孩子 | 無 | |
| 屬性 | 無 | |
| 擷取類別 |
SimpleEvent TranslationUnitType 預編譯標頭 |
|
| 說明 | 發起於前端階段的開頭,表示正在處理先行編譯的標頭(PCH)翻譯單元。 | |
| PRE_LTCG_OPT_REF | 類型 | 活動 |
| 父項 | PASS1 | |
| 孩子 | 無 | |
| 屬性 | 無 | |
| 擷取類別 |
活動 PreLTCGOptRef |
|
| 說明 | 發生在連結器優化階段的開始和結束時,移除未被參考的函式和資料(/OPT:REF)。 它會在連結時間程式碼產生之前完成。 | |
| SYMBOL_NAME | 類型 | 簡單事件 |
| 父項 | C1_DLL | |
| 孩子 | 無 | |
| 屬性 | - 類型鍵 - 類型的名稱 |
|
| 擷取類別 |
SimpleEvent SymbolName |
|
| 說明 | 在前端階段結束時發生:針對範本具現化所涉及的每一種類型一次。 索引鍵是型別的數值標識符,而名稱則是其文字表示法。 類型索引鍵在所分析的追蹤內是唯一的。 不過,來自不同編譯程式前端傳遞的不同索引鍵可能會指向相同的類型。 比較不同編譯器前端階段的類型時,需要使用它們的名稱。 在編譯器前端通過結束時發出 SYMBOL_NAME 事件,此時所有模板實例化都已完成。 | |
| TEMPLATE_INSTANTIATION | 類型 | 活動 |
| 父項 |
C1_DLL 前端檔案 模板實例化 |
|
| 孩子 | 模板實例化 | |
| 屬性 | - 特製化類型的索引鍵 - 主要範本類型的索引鍵 - 具現化的範本類型 |
|
| 擷取類別 |
活動 TemplateInstantiation |
|
| 說明 | 發生在範本具現化的開頭和結尾。 主要範本類型(例如vector)會具現化,導致特製化類型(例如std::vector<int>)。 兩種類型都會提供密鑰。
使用 SYMBOL_NAME 事件,將索引鍵轉換成類型的名稱。 類型索引鍵在所分析的追蹤內是唯一的。 不過,來自不同編譯程式前端傳遞的不同索引鍵可能會指向相同的類型。 比較不同編譯程式前端階段之間的類型需要使用符號名稱。 這個事件是遞歸的。 在某些情況下,當前端具現化巢狀範本時,就會發生遞歸。 |
|
| 線 | 類型 | 活動 |
| 父項 |
CODE_GENERATION 自上而下 |
|
| 孩子 | 功能 | |
| 屬性 | 無 | |
| 擷取類別 |
活動 線程 |
|
| 說明 | 發生在編譯程式後端線程執行的開頭和結尾。 暫停的線程會被視為結束。 正在喚醒的線程會被視為已啟動。 | |
| 自上而下 | 類型 | 活動 |
| 父項 | 整體程式分析 | |
| 孩子 |
功能 線 |
|
| 屬性 | 無 | |
| 擷取類別 |
活動 TopDown |
|
| 說明 | 發生於整個程式分析自上而下遍歷階段的開始和結束。 | |
| TRANSLATION_UNIT_TYPE | 類型 | 活動 |
| 父項 | 前端通過 | |
| 孩子 |
模組 HEADER_UNIT PRECOMPILED_HEADER |
|
| 屬性 | - 翻譯單位的類型。 | |
| 擷取類別 |
SimpleEvent TranslationUnitType |
|
| 說明 | 發生在前端階段的開頭。 此類型會識別此傳遞是否正在處理模組、標頭單位或先行編譯標頭。 | |
| 整體程式分析 | 類型 | 活動 |
| 父項 | C2_DLL | |
| 孩子 |
由下而上 自上而下 |
|
| 屬性 | 無 | |
| 擷取類別 |
活動 WholeProgramAnalysis |
|
| 說明 | 發生在連結時的程式碼生成全程分析階段的開始和結束。 |