Variabili d'ambiente per le ottimizzazioni GPO

Esistono tre variabili di ambiente che influiscono sugli scenari di test in un'immagine creata con /LTCG:PGI per le ottimizzazioni guidate dal profilo:

• PogoSafeMode specifica se usare la modalità rapida o la modalità provvisoria per la profilatura delle applicazioni.

• VCPROFILE_ALLOC_SCALE aggiunge memoria aggiuntiva per l'uso da parte del profiler.

• VCPROFILE_PATH consente di specificare la cartella usata per i file con estensione pgc.

Le variabili di ambiente PogoSafeMode e VCPROFILE_ALLOC_SCALE sono deprecate a partire da Visual Studio 2015. Le opzioni del linker /GENPROFILE o /FASTGENPROFILE e /USEPROFILE specificano lo stesso comportamento del linker di queste variabili di ambiente.

PogoSafeMode

Questa variabile di ambiente è deprecata. Utilizzare gli argomenti EXACT o NOEXACT per /GENPROFILE o /FASTGENPROFILE per controllare questo comportamento.

Deselezionare o impostare la variabile di ambiente PogoSafeMode per specificare se usare la modalità rapida o la modalità provvisoria per la profilatura delle applicazioni nei sistemi x86.

L'ottimizzazione PGO (Profile-Guided Optimization) ha due modalità possibili durante la fase di profilatura: modalità veloce e modalità provvisoria. Quando la profilatura è in modalità rapida, usa l'istruzione INC per aumentare i contatori dei dati. L'istruzione INC è più veloce, ma non è thread-safe. Quando la profilatura è in modalità provvisoria, usa l'istruzione LOCK INC per aumentare i contatori dei dati. L'istruzione LOCK INC ha la stessa funzionalità dell'istruzione INC ed è thread-safe, ma è più lenta rispetto all'istruzione INC .

Per impostazione predefinita, la profilatura PGO funziona in modalità rapida. PogoSafeMode è obbligatorio solo se si vuole usare la modalità provvisoria.

Per eseguire la profilatura PGO in modalità provvisoria, è necessario usare la variabile di ambiente PogoSafeMode o l'opzione del linker /PogoSafeMode, a seconda del sistema. Se si esegue la profilatura in un computer x64, è necessario usare l'opzione del linker. Se si esegue la profilatura in un computer x86, è possibile usare l'opzione del linker o impostare la variabile di ambiente PogoSafeMode su qualsiasi valore prima di avviare il processo di ottimizzazione.

Sintassi pogoSafeMode

set PogoSafeMode[=value]

Impostare PogoSafeMode su qualsiasi valore per abilitare la modalità provvisoria. Impostare senza un valore per cancellare un valore precedente e riabilitare la modalità rapida.

VCPROFILE_ALLOC_SCALE

Questa variabile di ambiente è deprecata. Usare gli argomenti MEMMIN e MEMMAX per /GENPROFILE o /FASTGENPROFILE per controllare questo comportamento.

Modificare la variabile di ambiente VCPROFILE_ALLOC_SCALE per modificare la quantità di memoria allocata per contenere i dati del profilo. In rari casi, non sarà disponibile memoria sufficiente per supportare la raccolta dei dati del profilo durante l'esecuzione di scenari di test. In questi casi, è possibile aumentare la quantità di memoria impostando VCPROFILE_ALLOC_SCALE. Se viene visualizzato un messaggio di errore durante un'esecuzione del test che indica che la memoria è insufficiente, assegnare un valore maggiore a VCPROFILE_ALLOC_SCALE, fino a quando il test non viene completato senza errori di memoria insufficiente.

sintassi VCPROFILE_ALLOC_SCALE

set VCPROFILE_ALLOC_SCALE[=scale_value]

Il parametro scale_value è un fattore di ridimensionamento per la quantità di memoria desiderata per gli scenari di test in esecuzione. Il valore predefinito è 1. Ad esempio, questa riga di comando imposta il fattore di scala su 2:

set VCPROFILE_ALLOC_SCALE=2

VCPROFILE_PATH

Usare la variabile di ambiente VCPROFILE_PATH per specificare la directory per creare file con estensione pgc. Per impostazione predefinita, i file con estensione pgc vengono creati nella stessa directory del file binario sottoposto a profilatura. Tuttavia, se il percorso assoluto del file binario non esiste, come nel caso in cui si eseguono scenari di profilo in un computer diverso da cui è stato compilato il file binario, è possibile impostare VCPROFILE_PATH su un percorso esistente nel computer di destinazione.

sintassi VCPROFILE_PATH

set VCPROFILE_PATH[=path]

Impostare il parametro path sul percorso della directory in cui aggiungere file con estensione pgc. Ad esempio, questa riga di comando imposta la cartella su C:\profile:

set VCPROFILE_PATH=c:\profile

Vedi anche

Ottimizzazioni PGO
/GENPROFILE e /FASTGENPROFILE
/USEPROFILE