Dela via

/GENPROFILE, /FASTGENPROFILE (Generera profilering instrumenterad version)

Anger generering av en .pgd fil av länkaren för att stödja profilstyrd optimering (PGO). /GENPROFILE och /FASTGENPROFILE använda olika standardparametrar. Använd /GENPROFILE för att gynna precision framför hastighets- och minnesanvändning under profilering. Använd /FASTGENPROFILE för att gynna mindre minnesanvändning och hastighet framför precision.

Syntax

/GENPROFILE[:profile-argument[,profile-argument ...]]
/FASTGENPROFILE[:profile-argument[,profile-argument ...]]

profile-argument
 { COUNTER32 | COUNTER64 }
 { EXACT | NOEXACT }
  MEMMAX= värde
  MEMMIN= värde
 { PATH | NOPATH }
 { TRACKEH | NOTRACKEH }
  PGD= filnamn

Argument

Något av de profile-argument argumenten kan anges till /GENPROFILE eller /FASTGENPROFILE. Argument som anges här avgränsade med ett pipe-tecken (|) utesluts ömsesidigt. Använd ett kommatecken (,) för att separera argument. Placera inte blanksteg mellan argument, kommatecken eller efter kolonet (:).

COUNTER32 | COUNTER64
Använd COUNTER32 för att ange användningen av 32-bitars avsökningsräknare och COUNTER64 för att ange 64-bitars avsökningsräknare. När du anger /GENPROFILEär standardvärdet COUNTER64. När du anger /FASTGENPROFILEär standardvärdet COUNTER32.

EXACT | NOEXACT
Använd EXACT för att ange trådsäkra sammankopplade steg för avsökningar. NOEXACT anger oskyddade inkrementsåtgärder för avsökningar. Standardvärdet är NOEXACT.

MEMMAX = värdetMEMMIN=
Använd MEMMAX och MEMMIN för att ange maximal och minsta reservationsstorlek för träningsdata i minnet. Värdet är mängden minne som ska reserveras i byte. Som standard bestäms dessa värden av en intern heuristisk.

PATH | NOPATH
Använd PATH för att ange en separat uppsättning PGO-räknare för varje unik sökväg till en funktion. Använd NOPATH om du bara vill ange en uppsättning räknare för varje funktion. När du anger /GENPROFILEär standardvärdet PATH . När du anger /FASTGENPROFILEär standardvärdet NOPATH .

TRACKEH | NOTRACKEH
Anger om du vill använda extra räknare för att hålla ett korrekt antal när undantag utlöses under träningen. Använd TRACKEH för att ange extra räknare för ett exakt antal. Använd NOTRACKEH för att ange enskilda räknare för kod som inte använder undantagshantering eller som inte stöter på undantag i dina träningsscenarier. När du anger /GENPROFILEär standardvärdet TRACKEH . När du anger /FASTGENPROFILEär standardvärdet NOTRACKEH .

PGD = filnamn
Anger ett basfilnamn för .pgd-filen. Som standard använder länkaren det körbara basavbildningsfilnamnet med ett .pgd-tillägg.

Anmärkningar

Alternativen /GENPROFILE och /FASTGENPROFILE instruerar länkaren att generera den profilinstrumentationsfil som behövs för att stödja programträning för profilstyrd optimering (PGO). De här alternativen är nya i Visual Studio 2015. Använd de här alternativen till de inaktuella alternativen /LTCG:PGINSTRUMENT, /PGDoch /POGOSAFEMODE samt miljövariablerna PogoSafeMode, VCPROFILE_ALLOC_SCALEoch VCPROFILE_PATH. Profileringsinformationen som genereras av programträningen används som indata för riktade optimeringar av hela programmet under byggen. Du kan också ange andra alternativ för att styra olika profileringsfunktioner för prestanda under appträning och versioner. Standardalternativen som anges av /GENPROFILE ger de mest exakta resultaten, särskilt för stora, komplexa appar med flera trådar. Alternativet /FASTGENPROFILE använder olika standardvärden för ett lägre minnesavtryck och snabbare prestanda under träning, på bekostnad av noggrannhet.

Profileringsinformation samlas in när du kör den instrumenterade appen när du har skapat med hjälp av /GENPROFILE av /FASTGENPROFILE. Den här informationen samlas in när du anger alternativet /USEPROFILE länkare för att utföra profileringssteget och sedan används för att vägleda det optimerade byggsteget. Mer information om hur du tränar din app och information om insamlade data finns i Profilstyrda optimeringar.

Ange alltid /LTCG när du anger /GENPROFILE eller /FASTGENPROFILE.

Ange det här länkalternativet i Visual Studio-utvecklingsmiljön

  1. Öppna dialogrutan egenskapssidor för projektet. Mer information finns i Ange C++-kompilator- och byggegenskaper i Visual Studio.

  2. Välj egenskapssidan Konfigurationsegenskaper>Linker>kommandorad.

  3. Ange alternativ och argument för /GENPROFILE eller /FASTGENPROFILE i rutan Ytterligare alternativ. Välj OK för att spara ändringarna.

Så här ställer du in det här länkalternativet programmatiskt

Se även

referens för MSVC-länkare
MSVC-länkalternativ
/LTCG (länktidskodgenerering)