pgosweep
Wird bei der profilgesteuerten Optimierung verwendet, um alle Profildaten aus einem laufenden Programm in die PGC-Datei zu schreiben.
Syntax
pgosweep[Optionen] Image PGC-Datei
Parameter
Optionen
(Optional) Die gültigen Werte für die Optionen lauten wie folgt:
/?oder/helpzeigt die Hilfsmeldung an./resetsetzt den Zähler nach dem Sweep auf Null zurück. Dies ist das Standardverhalten./pid:nführt nur für die angegebene PID einen Sweepvorgang durch. n ist die PID./waitwartet, bis die angegebene PID beendet wurde, bevor die Zähler erfasst werden./onlyzerospeichert keine PGC-Datei. Nur Nullzähler./pausehält das Sammeln der Zähler für das System an./resumesetzt das Sammeln der Zähler für das System fort./noresetbehält die Zähler in den Laufzeitdatenstrukturen bei.
Abbildung
Der vollständige Pfad einer EXE- oder DLL-Datei, die mit der Option /GENPROFILE, /FASTGENPROFILE oder /LTCG:PGINSTRUMENT erstellt wurde.
pgcfile
Die PGC-Datei, in der dieser Befehl die Datenzähler ausgibt.
Hinweise
Der Befehl pgosweep kann für Programme verwendet werden, die mit der Option /GENPROFILE oder /FASTGENPROFILE bzw. mit der veralteten Option /LTCG:PGINSTRUMENT erstellt wurden. Durch den Befehl wird ein Programm unterbrochen, und Profildaten werden in eine neue PGC-Datei geschrieben. Standardmäßig setzt der Befehl die Anzahl nach jedem Schreibvorgang zurück. Wenn Sie die Option /noreset angeben, werden die Werte vom Befehl aufgezeichnet, aber nicht im laufenden Programm zurückgesetzt. Mit dieser Option erhalten Sie doppelte Daten, wenn Sie die Profildaten zu einem späteren Zeitpunkt abrufen.
Eine alternative Verwendungsmöglichkeit von pgosweep besteht darin, Profilinformationen nur für den normalen Anwendungsbetrieb abzurufen. Sie können pgosweep beispielsweise kurz nach dem Start der Anwendung ausführen und die Datei verwerfen. Dadurch werden die mit Startkosten verknüpften Profildaten entfernt. Anschließend können Sie pgosweep ausführen, bevor Sie die Anwendung beenden. Die gesammelten Daten verfügen dann nur über die Profilinformationen aus der Zeit, in der der Benutzer mit dem Programm interagieren konnte.
Wenn Sie eine PGC-Datei benennen (mithilfe des pgcfile-Parameters), können Sie das Standardformat appname!n.pgc verwenden. n ist ein steigender numerischer Wert für die einzelnen Dateien. Wenn Sie dieses Format verwenden, sucht der Compiler in der Phase /LTCG /USEPROFILE oder /LTCG:PGO automatisch nach diesen Daten. Wenn Sie das Standardformat nicht verwenden, müssen Sie pgomgr verwenden, um die PGC-Dateien zusammenzuführen.
Hinweis
Sie können dieses Tool nur über eine Developer-Eingabeaufforderung von Visual Studio starten. Sie können es nicht von einer Systemeingabeaufforderung oder vom Datei-Explorer aus starten.
Informationen zum Erfassen der Profildaten in der ausführbaren Datei finden Sie unter PgoAutoSweep.
Beispiel
In diesem Beispielbefehl schreibt pgosweep die aktuellen Profilinformationen für myapp.exe in myapp!1.pgc.
pgosweep myapp.exe myapp!1.pgc