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, /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 /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

Vedi anche

Ottimizzazioni PGO
PgoAutoSweep