pgosweep

Wird bei der profilgesteuerten Optimierung verwendet, um alle Profildaten aus einem laufenden Programm in die PGC-Datei zu schreiben.

Syntax

pgosweep [options] Imagepgcfile

Parameter

Optionen
(Optional) Die gültigen Werte für die Optionen lauten wie folgt:

• /? oder /help zeigt die Hilfsmeldung an.

• /reset setzt den Zähler nach dem Sweep auf Null zurück. Dies ist das Standardverhalten.

• /pid:n führt nur für die angegebene PID einen Sweepvorgang durch. n ist die PID.

• /wait wartet, bis die angegebene PID beendet wurde, bevor die Zähler erfasst werden.

• /onlyzero speichert keine PGC-Datei. Nur Nullzähler.

• /pause hält das Sammeln der Zähler für das System an.

• /resume setzt das Sammeln der Zähler für das System fort.

• /noreset behä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

Siehe auch

Profilgesteuerte Optimierungen
PgoAutoSweep