共用方式為


pgosweep

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

語法

pgosweep [options] image pgcfile

參數

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

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

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

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

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

  • /onlyzero 不會儲存 PGC 檔案,只有零個計數。

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

  • /resume 會繼續進行系統上的計數收集。

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

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

pgcfile
此命令寫出資料計數的 PGC 檔案。

備註

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

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

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

注意

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

如需有關如何從可執行檔內擷取設定檔資料的資訊,請參閱 PgoAutoSweep (部分機器翻譯)。

範例

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

pgosweep myapp.exe myapp!1.pgc

另請參閱

特性指引最佳化
PgoAutoSweep