pgosweep

用於特性指引最佳化,可將所有設定檔資料從執行中的程式寫入 PGC 檔案。

語法

pgosweep [選項] 圖片PGCFILE

參數

選項
(選擇性)「options」的有效值為:

  • /? 或 /help 會顯示說明訊息。

  • /reset 會將掃描之後的計數重設為零。 這是預設行為。

  • /pid:n 只掃描指定的 PID,其中 n 是 PID 號碼。

  • /wait 會等待指定的 PID 終止再收集計數。

  • /onlyzero 不會儲存 PGC 檔案,只會記錄零次。

  • /pause 會暫停系統上的計數收集。

  • /resume 恢復系統上的計數資料收集。

  • /noreset 會保留執行階段資料結構中的計數。

圖像
使用 /GENPROFILE、/FASTGENPROFILE 或 /LTCG:PGINSTRUMENT 選項建立之 EXE 或 DLL 檔案的完整路徑。

pgcfile
此命令將資料計數寫入 PGC 檔案中。

備註

pgosweep 命令適用於使用 /GENPROFILE 或 /FASTGENPROFILE 選項或已取代之 /LTCG:PGINSTRUMENT 選項所建置的程式。 它會中斷執行中的程式,並將設定檔資料寫入新的 PGC 檔案。 根據預設,此命令會在每個寫入作業之後重設計數。 如果您指定 /noreset 選項,此命令會記錄值,但不會在執行中的程式中重設這些值。 如果您稍後擷取設定檔資料,此選項會提供重複的資料。

pgosweep 的替代用法是只擷取應用程式正常作業的設定檔資訊。 例如,您可以在啟動應用程式並捨棄該檔案不久之後執行 pgosweep。 此命令會移除與啟動成本相關聯的設定檔資料。 然後,您可以在結束應用程式之前執行 pgosweep。 現在,收集的資料僅包含從使用者能與程式互動的時間起的設定檔資訊。

當您命名 PGC 檔案時 (使用 pgcfile 參數),您可以使用標準格式,也就是 appname!n.pgc。 n 代表每個檔案增加的數值。 如果您使用此格式,編譯器會在 /LTCG /USEPROFILE 或 /LTCG:PGO 階段自動尋找此資料。 如果您沒有使用標準格式,則必須使用 pgomgr 來合併 PGC 檔案。

注意

您只能從 Visual Studio 開發人員命令提示字元中啟動此工具。 您無法從系統命令提示字元或檔案總管執行它。

若要了解如何在您的可執行檔中擷取分析資料的更多資訊,請參閱 PgoAutoSweep。

範例

在此範例命令中,pgosweep 將 myapp.exe 目前的設定檔資訊寫入至 myapp!1.pgc。

pgosweep myapp.exe myapp!1.pgc

另請參閱

剖析導向最佳化
PgoAutoSweep