共用方式為


參考:vcperf 命令

C++ Build Insights 工具可從 Visual Studio 2019 和更新版本開始取得。 若要查看該版本的檔,請將本文的Visual Studio 版本 選取器控件設定為Visual Studio 2019或更新版本。 其位於此頁面目錄頂端。

本文列出並描述 中 vcperf.exe可用的命令,以及如何使用這些命令。

啟動和停止追蹤的命令

重要

除非您指定 /noadmin,否則下列命令需要系統管理許可權。

選項 自變數和描述
/start [] [/noadmin] [] [/level1 | | /level2/level3]/nocpusampling<sessionName>
在指定的工作階段名稱下啟動追蹤。

選項/noadmin執行vcperf.exe沒有系統管理員許可權,而且會忽略/nocpusampling選項。 當您在沒有系統管理員許可權的情況下執行 vcperf 時,指定的計算機上可能會有多個使用中的會話。

選項 /nocpusampling 指定 vcperf.exe 不會收集CPU樣本。 它可防止在 Windows 效能分析器 中使用 CPU 使用量(取樣)檢視,但會使收集的追蹤更小。

/level1/level2/level3 選項會指定要收集哪些 MSVC 事件,以增加資訊層級。 層級 3 包含所有事件。 層級 2 包含範本具現化事件以外的所有事件。 層級 1 包含範本具現化、函式和檔案事件以外的所有事件。 如果未指定, /level2 預設會選取 。

一旦 vcperf.exe 啟動追蹤,就會立即傳回。 追蹤會針對電腦上執行的所有進程收集全系統的事件。 這表示您不需要在與用來執行 vcperf.exe相同的命令提示字元視窗中建置專案。 例如,您可以在 Visual Studio 中建置專案。
/stop (1) [/templates] <sessionName> <outputFile.etl>
(2) [/templates] <sessionName> /timetrace <outputFile.json>
停止指定工作階段名稱所識別的追蹤。 在追蹤上執行後處理步驟,以產生 參數指定的 <outputFile> 檔案。

選項 /templates 包含檔案中的範本具現化事件。

(1) 在 Windows 效能分析器 (WPA) 中產生可檢視的檔案。 輸出檔案需要擴展名 .etl
(2) 在 Microsoft Edge 追蹤查看器中產生可檢視的檔案(edge://tracing)。 輸出檔案需要擴展名 .json
/stopnoanalyze <sessionName> <rawOutputFile.etl>
停止指定工作階段名稱所識別的追蹤,並在指定的輸出檔中寫入未經處理的原始資料。 產生的檔案不適用於在 WPA 中檢視。

命令中 /stop 涉及的後續處理步驟有時可能相當冗長。 您可以使用 /stopnoanalyze 命令來延遲這個後續處理步驟。 /analyze當您準備好在 Windows 效能分析器 或 Microsoft Edge 追蹤查看器中產生可檢視的檔案時,請使用 命令。

其他命令

選項 自變數和描述
/analyze (1) [/templates] <rawInputFile.etl> <outputFile.etl>
(2) [/templates] <rawInputFile.etl> /timetrace <outputFile.json>
接受命令所產生的 /stopnoanalyze 原始追蹤檔案。 在此追蹤上執行後處理步驟,以產生 參數所 <outputFile> 指定的檔案。

選項 /templates 包含檔案中的範本具現化事件。

(1) 在 Windows 效能分析器 (WPA) 中產生可檢視的檔案。 輸出檔案需要擴展名 .etl

(2) 在 Microsoft Edge 追蹤查看器中產生可檢視的檔案(edge://tracing)。 輸出檔案需要擴展名 .json

另請參閱

開始使用 C++ Build Insights
教學課程:Windows 效能分析器 基本概念
參考:Windows 效能分析器 檢視
Windows Performance Analyzer