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.pgc。 n 代表每個檔案增加的數值。 如果您使用此格式，編譯器會在 /LTCG /USEPROFILE 或 /LTCG:PGO 階段自動尋找此資料。 如果您沒有使用標準格式，則必須使用 pgomgr 來合併 PGC 檔案。

注意

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

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

範例

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

pgosweep myapp.exe myapp!1.pgc

另請參閱

特性指引最佳化
PgoAutoSweep