Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Usato nell'ottimizzazione guidata dal profilo per scrivere tutti i dati del profilo da un programma in esecuzione nel file PGC.
Sintassi
pgosweep[opzioni] immaginepgcfile
Parametri
Opzioni
(Facoltativo) I valori validi per le opzioni sono:
/?o/helpvisualizza un messaggio di aiuto./resetreimposta i conteggi su zero dopo la scansione. Questo è il comportamento predefinito./pid:nesegue lo sweep solo del PID specificato, dove n è il numero PID./waitattende che il PID specificato termini prima di raccogliere i conteggi./onlyzeronon salva un file PGC, solo zero conteggi./pausesospende la raccolta dei conteggi nel sistema./resumeriprende la raccolta dei conteggi nel sistema./noresetmantiene il conteggio nelle strutture dati di runtime.
Immagine
Percorso completo di un file EXE o DLL creato usando l'opzione /GENPROFILE, /FASTGENPROFILEo /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 fase /LTCG /USEPROFILE 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, pgosweep scrive le informazioni sul profilo corrente da myapp.exe a myapp!1.pgc.
pgosweep myapp.exe myapp!1.pgc