pgosweep
Usato nell'ottimizzazione guidata dal profilo per scrivere tutti i dati del profilo da un programma in esecuzione nel file PGC.
Sintassi
pgosweep
[opzioni] immagine pgcfile
Parametri
options
(Facoltativo) I valori validi per le opzioni sono:
/?
o/help
visualizza il messaggio della Guida./reset
reimposta i conteggi su zero dopo lo sweep. Questo è il comportamento predefinito./pid:n
esegue lo sweep solo del PID specificato, dove n è il numero PID./wait
attende che il PID specificato termini prima di raccogliere i conteggi./onlyzero
non salva un file PGC, solo zero conteggi./pause
sospende la raccolta dei conteggi nel sistema./resume
riprende la raccolta dei conteggi nel sistema./noreset
mantiene il conteggio nelle strutture dei dati di runtime.
Immagine
Percorso completo di un file EXE o DLL creato usando l'opzione /GENPROFILE
, /FASTGENPROFILE
o /LTCG:PGINSTRUMENT
.
pgcfile
File PGC in cui questo comando scrive i conteggi dei dati.
Osservazioni:
Il pgosweep
comando funziona sui programmi compilati usando l'opzione /GENPROFILE
o /FASTGENPROFILE
o l'opzione deprecata /LTCG:PGINSTRUMENT
. Interrompe un programma in esecuzione e scrive i dati del profilo in un nuovo file PGC. Per impostazione predefinita, il comando reimposta i conteggi dopo ogni operazione di scrittura. Se si specifica l'opzione /noreset
, il comando registrerà i valori, ma non li reimposta nel programma in esecuzione. Questa opzione consente di duplicare i dati se si recuperano i dati del profilo in un secondo momento.
Un uso alternativo per pgosweep
è quello di recuperare le informazioni sul profilo solo per il normale funzionamento dell'applicazione. Ad esempio, è possibile eseguire pgosweep
poco dopo l'avvio dell'applicazione e rimuovere il file. Questo comando rimuove i dati del profilo associati ai costi di avvio. È quindi possibile eseguire pgosweep
prima di terminare l'applicazione. Ora i dati raccolti contengono informazioni sul profilo solo dal momento in cui l'utente può interagire con il programma.
Quando si assegna un nome a un file PGC (usando il parametro pgcfile ) è possibile usare il formato standard, ovvero appname!n.pgc
. N rappresenta un valore numerico crescente per ogni file. Se si usa questo formato, il compilatore trova automaticamente questi dati nella /LTCG /USEPROFILE
fase o /LTCG:PGO
. Se non si usa il formato standard, è necessario usare pgomgr
per unire i file PGC.
Nota
È possibile avviare questo strumento solo da un prompt dei comandi per sviluppatori di Visual Studio. Non è possibile avviarlo da un prompt dei comandi di sistema o da Esplora file.
Per informazioni su come acquisire i dati del profilo dall'interno del file eseguibile, vedere PgoAutoSweep
.
Esempio
In questo comando di esempio scrive pgosweep
le informazioni sul profilo corrente per in myapp.exe
myapp!1.pgc
.
pgosweep myapp.exe myapp!1.pgc