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