pgosweep

用於設定檔引導式優化，將所有設定檔資料從執行中的程式寫入 PGC 檔案。

語法

pgosweep[ options ] image pgcfile

參數

options
（選擇性）選項 的有效值為 ：

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

• /reset 會將清掃之後的計數重設為零。 此行為是預設值。

• /pid:n 只會掃掠指定的 PID，其中 n 是 PID 數位。

• /wait 等候指定的 PID 在收集計數之前終止。

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

• /pause 會暫停系統上的 count 集合。

• /resume 會繼續系統上的 count 集合。

• /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:PGO 階段中 /LTCG /USEPROFILE 尋找此資料。 如果您沒有使用標準格式，則必須使用 pgomgr 來合併 PGC 檔案。

注意

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

如需如何從可執行檔內擷取設定檔資料的資訊，請參閱 PgoAutoSweep 。

範例

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

pgosweep myapp.exe myapp!1.pgc

另請參閱

特性指引最佳化
PgoAutoSweep