C++ Build Insights SDK'sı: olay tablosu
C++ Build Insights SDK'sı Visual Studio 2017 ve sonraki sürümlerle uyumludur. Bu sürümlerin belgelerini görmek için bu makalenin Visual Studio Sürüm seçici denetimini Visual Studio 2017 veya üzeri olarak ayarlayın. Bu sayfadaki içindekiler tablosunun en üstünde bulunur.
Derleyici olayları
DERLEYİCİ
COMMAND_LINE
ENVIRONMENT_VARIABLE
FILE_INPUT
OBJ_OUTPUT
FRONT_END_PASS
BACK_END_PASS
Derleyici ön uç olayları
C1_DLL
FRONT_END_FILE
TEMPLATE_INSTANTIATION
SYMBOL_NAME
MODÜL
HEADER_UNIT
PRECOMPILED_HEADER
Derleyici arka uç olayları
C2_DLL
WHOLE_PROGRAM_ANALYSIS
TOP_DOWN
BOTTOM_UP
CODE_GENERATION
İPLİK
FUNCTION
FORCE_INLINEE
Bağlayıcı olayları
BAĞLAYICI
COMMAND_LINE
ENVIRONMENT_VARIABLE
FILE_INPUT
EXECUTABLE_IMAGE_OUTPUT
EXP_OUTPUT
IMP_LIB_OUTPUT
LIB_OUTPUT
PASS1
PRE_LTCG_OPT_REF
LTCG
OPT_REF
OPT_ICF
OPT_LBR
PASS2
Olay tablosu
Etkinlik | Özellik | Açıklama |
---|---|---|
BACK_END_PASS | Tür | Etkinlik |
Üst Öğeler | DERLEYİCİ | |
Alt Öğeler | C2_DLL | |
Properties | - Giriş kaynak dosyasının mutlak yolu - Çıktı nesne dosyasının mutlak yolu |
|
Yakalama sınıfları | Etkinlik Derleyici Geçidi BackEndPass |
|
Açıklama | Derleyici arka uç geçişinin başlangıcında ve durdurulmasında gerçekleşir. Bu geçiş ayrıştırılmış C/C++ kaynak kodunu iyileştirmekten ve makine koduna dönüştürmekten sorumludur. | |
BOTTOM_UP | Tür | Etkinlik |
Üst Öğeler | WHOLE_PROGRAM_ANALYSIS | |
Alt Öğeler | Hiçbiri | |
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik BottomUp |
|
Açıklama | Tüm program analizinin alttan yukarı geçişinin başlangıcında ve durdurulmasında gerçekleşir. | |
C1_DLL | Tür | Etkinlik |
Üst Öğeler | FRONT_END_PASS | |
Alt Öğeler | FRONT_END_FILE SYMBOL_NAME TEMPLATE_INSTANTIATION |
|
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik C1DLL |
|
Açıklama | bir c1.dll veya c1xx.dll çağrısının başlangıcında ve durdurulmasında gerçekleşir. Bu DLL'ler, derleyicinin C ve C++ ön ucu olur. Bunlar yalnızca derleyici sürücüsü (cl.exe) tarafından çağrılır. | |
C2_DLL | Tür | Etkinlik |
Üst Öğeler | BACK_END_PASS LTCG |
|
Alt Öğeler | CODE_GENERATION WHOLE_PROGRAM_ANALYSIS |
|
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik C2DLL |
|
Açıklama | c2.dll çağrısının başlangıcında ve durdurulmasında gerçekleşir. Bu DLL, derleyicinin arka ucudur. Derleyici sürücüsü (cl.exe) tarafından çağrılır. Bağlantı zamanı kodu oluşturma kullanıldığında bağlayıcı (link.exe) tarafından da çağrılır. | |
CODE_GENERATION | Tür | Etkinlik |
Üst Öğeler | C2_DLL | |
Alt Öğeler | FUNCTION İPLİK |
|
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik CodeGeneration |
|
Açıklama | Arka ucun kod oluşturma aşamasının başlangıcında ve durdurulmasında gerçekleşir. | |
COMMAND_LINE | Tür | Basit Olay |
Üst Öğeler | DERLEYİCİ BAĞLAYICI |
|
Alt Öğeler | Hiçbiri | |
Properties | - cl.exe veya link.exe çağırmak için kullanılan komut satırı | |
Yakalama sınıfları | SimpleEvent Komut Satırı |
|
Açıklama | Derleyici ve bağlayıcı komut satırını değerlendirmeyi bitirdiğinde gerçekleşir. Değerlendirilen komut satırı, bir yanıt dosyası aracılığıyla geçirilen tüm cl.exe ve link.exe parametrelerini içerir. Ayrıca CL, _CL_, LINK ve _LINK_ gibi ortam değişkenleri aracılığıyla geçirilen cl.exe ve link.exe parametreleri de içerir. | |
DERLEYİCİ | Tür | Etkinlik |
Üst Öğeler | Hiçbiri | |
Alt Öğeler | BACK_END_PASS COMMAND_LINE ENVIRONMENT_VARIABLE FILE_INPUT OBJ_OUTPUT FRONT_END_PASS |
|
Properties | - Derleyici sürümü - Çalışma dizini - Çağrılan cl.exe mutlak yolu |
|
Yakalama sınıfları | Etkinlik Çağırma Derleyici |
|
Açıklama | bir cl.exe çağrısının başlangıcında ve durdurulmasında gerçekleşir. | |
ENVIRONMENT_VARIABLE | Tür | Basit Olay |
Üst Öğeler | DERLEYİCİ BAĞLAYICI |
|
Alt Öğeler | Hiçbiri | |
Properties | - Ortam değişkeninin adı - Ortam değişkeninin değeri. |
|
Yakalama sınıfları | SimpleEvent EnvironmentVariable |
|
Açıklama | cl.exe veya link.exe çağrıldığında var olan her ortam değişkeni için bir kez gerçekleşir. | |
EXECUTABLE_IMAGE_OUTPUT | Tür | Basit Olay |
Üst Öğeler | BAĞLAYICI | |
Alt Öğeler | Hiçbiri | |
Properties | - DLL veya yürütülebilir çıktı dosyasının mutlak yolu. | |
Yakalama sınıfları | SimpleEvent FileOutput ExecutableImageOutput |
|
Açıklama | Bağlayıcı girişlerinden biri DLL veya yürütülebilir görüntü dosyası olduğunda gerçekleşir. | |
EXP_OUTPUT | Tür | Basit Olay |
Üst Öğeler | BAĞLAYICI | |
Alt Öğeler | Hiçbiri | |
Properties | - .exp çıkış dosyasının mutlak yolu. | |
Yakalama sınıfları | SimpleEvent FileOutput ExpOutput |
|
Açıklama | Bağlayıcı çıkışlarından biri bir .exp dosyası olduğunda gerçekleşir. | |
FILE_INPUT | Tür | Basit Olay |
Üst Öğeler | DERLEYİCİ BAĞLAYICI |
|
Alt Öğeler | Hiçbiri | |
Properties | - Giriş dosyasının mutlak yolu - Giriş dosyasının türü |
|
Yakalama sınıfları | SimpleEvent FileInput |
|
Açıklama | bir cl.exe veya link.exe girişi duyurmak için gerçekleşir. | |
FORCE_INLINEE | Tür | Basit Olay |
Üst Öğeler | FUNCTION | |
Alt Öğeler | Hiçbiri | |
Properties | - Force-inlined işlevinin adı. - Ara yönerge sayısı olarak temsil edilen force-inlined işlevinin boyutu. |
|
Yakalama sınıfları | Etkinlik ForceInlinee |
|
Açıklama | Bir işlev, anahtar sözcüğü kullanılarak __forceinline başka bir işleve zorla çizildiğinde gerçekleşir. |
|
FRONT_END_FILE | Tür | Etkinlik |
Üst Öğeler | C1_DLL FRONT_END_FILE |
|
Alt Öğeler | FRONT_END_FILE TEMPLATE_INSTANTIATION |
|
Properties | - Dosyanın mutlak yolu. | |
Yakalama sınıfları | Etkinlik FrontEndFile |
|
Açıklama | Derleyici ön ucu başlatıldığında ve bir dosyayı işlemeyi durdurduğunda gerçekleşir. Bu olay özyinelemeli. Özyineleme, ön uç dahil edilen dosyaları ayrıştırdığında gerçekleşir. | |
FRONT_END_PASS | Tür | Etkinlik |
Üst Öğeler | DERLEYİCİ | |
Alt Öğeler | C1_DLL MODÜL HEADER_UNIT PRECOMPILED_HEADER |
|
Properties | - Giriş kaynak dosyasının mutlak yolu - Çıktı nesne dosyasının mutlak yolu |
|
Yakalama sınıfları | Etkinlik Derleyici Geçidi FrontEndPass |
|
Açıklama | Derleyici ön uç geçişinin başında ve durağında gerçekleşir. Bu geçiş, C/C++ kaynak kodunu ayrıştırmak ve ara dile dönüştürmekten sorumludur. | |
FONKSİYON | Tür | Etkinlik |
Üst Öğeler | CODE_GENERATION İPLİK TOP_DOWN |
|
Alt Öğeler | FORCE_INLINEE | |
Properties | - İşlevin adı | |
Yakalama sınıfları | Etkinlik İşlev |
|
Açıklama | bir işlev için kod oluşturulurken başlatılırken ve sonlandırıldığında gerçekleşir. | |
HEADER_UNIT | Tür | Etkinlik |
Üst Öğeler | FRONT_END_PASS | |
Alt Öğeler | Hiçbiri | |
Properties | Hiçbiri | |
Yakalama sınıfları | SimpleEvent TranslationUnitType HeaderUnit |
|
Açıklama | Ön uç geçişinin başında gerçekleşir ve üst bilgi birimi çeviri biriminin işlendiğini temsil eder. | |
IMP_LIB_OUTPUT | Tür | Basit Olay |
Üst Öğeler | BAĞLAYICI | |
Alt Öğeler | Hiçbiri | |
Properties | - İçeri aktarma kitaplığı çıkış dosyasının mutlak yolu. | |
Yakalama sınıfları | SimpleEvent FileOutput ImpLibOutput |
|
Açıklama | Bağlayıcının çıkışlarından biri içeri aktarma kitaplığı olduğunda gerçekleşir. | |
LIB_OUTPUT | Tür | Basit Olay |
Üst Öğeler | BAĞLAYICI | |
Alt Öğeler | Hiçbiri | |
Properties | - Statik kitaplık çıkış dosyasının mutlak yolu. | |
Yakalama sınıfları | SimpleEvent FileOutput LibOutput |
|
Açıklama | Bağlayıcının çıkışlarından biri statik kitaplık olduğunda gerçekleşir. | |
BAĞLAYICI | Tür | Etkinlik |
Üst Öğeler | Hiçbiri | |
Alt Öğeler | COMMAND_LINE ENVIRONMENT_VARIABLE EXECUTABLE_IMAGE_OUTPUT EXP_OUTPUT FILE_INPUT IMP_LIB_OUTPUT LIB_OUTPUT PASS1 PASS2 |
|
Properties | - Bağlayıcı sürümü - Çalışma dizini - Çağrılan link.exe mutlak yolu |
|
Yakalama sınıfları | Etkinlik Çağırma Bağlayıcı |
|
Açıklama | link.exe çağrısının başlangıcında ve durdurulmasında gerçekleşir. | |
LTCG | Tür | Etkinlik |
Üst Öğeler | PASS1 | |
Alt Öğeler | C2_DLL | |
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik LTCG |
|
Açıklama | Bağlantı zamanı kod oluşturmanın başlangıcında ve durdurulmasında gerçekleşir. | |
MODÜL | Tür | Etkinlik |
Üst Öğeler | FRONT_END_PASS | |
Alt Öğeler | Hiçbiri | |
Properties | Hiçbiri | |
Yakalama sınıfları | SimpleEvent TranslationUnitType Modül |
|
Açıklama | Ön uç geçişinin başında gerçekleşir ve modül çevirisi biriminin işlendiğini temsil eder. | |
OBJ_OUTPUT | Tür | Basit Olay |
Üst Öğeler | DERLEYİCİ | |
Alt Öğeler | Hiçbiri | |
Properties | - .obj çıkış dosyasının mutlak yolu | |
Yakalama sınıfları | SimpleEvent FileOutput ObjOutput |
|
Açıklama | cl.exe tarafından üretilen her .obj çıkışı için bir kez gerçekleşir. | |
OPT_ICF | Tür | Etkinlik |
Üst Öğeler | PASS1 | |
Alt Öğeler | Hiçbiri | |
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik OptICF |
|
Açıklama | Aynı COMDAT katlama (/OPT:ICF) bağlayıcı iyileştirmesinin başlangıcında ve durdurulmasında gerçekleşir. | |
OPT_LBR | Tür | Etkinlik |
Üst Öğeler | PASS1 | |
Alt Öğeler | Hiçbiri | |
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik OptLBR |
|
Açıklama | Uzun dal (/OPT:LBR) bağlayıcı iyileştirmesinin başlangıcında ve durdurulmasında gerçekleşir. | |
OPT_REF | Tür | Etkinlik |
Üst Öğeler | PASS1 | |
Alt Öğeler | Hiçbiri | |
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik OptRef |
|
Açıklama | Başvurulmayan işlevlerin ve veri eleme (/OPT:REF) bağlayıcı iyileştirmesinin başlangıcında ve durdurulmasında gerçekleşir. | |
PASS1 | Tür | Etkinlik |
Üst Öğeler | BAĞLAYICI | |
Alt Öğeler | LTCG OPT_ICF OPT_LBR OPT_REF |
|
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik Geçiş1 |
|
Açıklama | Bağlayıcının 1. parolasının başında ve durağında gerçekleşir. | |
PASS2 | Tür | Etkinlik |
Üst Öğeler | BAĞLAYICI | |
Alt Öğeler | Hiçbiri | |
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik Geçiş2 |
|
Açıklama | Bağlayıcının 2. parolasının başında ve durağında gerçekleşir. | |
PRECOMPILED_HEADER | Tür | Etkinlik |
Üst Öğeler | FRONT_END_PASS | |
Alt Öğeler | Hiçbiri | |
Properties | Hiçbiri | |
Yakalama sınıfları | SimpleEvent TranslationUnitType Önceden DerlenmişHeader |
|
Açıklama | Ön uç geçişinin başında gerçekleşir ve önceden derlenmiş bir üst bilgi (PCH) çeviri biriminin işlendiğini temsil eder. | |
PRE_LTCG_OPT_REF | Tür | Etkinlik |
Üst Öğeler | PASS1 | |
Alt Öğeler | Hiçbiri | |
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik PreLTCGOptRef |
|
Açıklama | Başvurulmayan işlevleri ve verileri (/OPT:REF) ortadan kaldıran bağlayıcı iyileştirme geçişinin başında ve durağında gerçekleşir. Bağlantı zamanı kodu oluşturmadan önce yapılır. | |
SYMBOL_NAME | Tür | Basit Olay |
Üst Öğeler | C1_DLL | |
Alt Öğeler | Hiçbiri | |
Properties | - Tür anahtarı - Türün adı |
|
Yakalama sınıfları | SimpleEvent SymbolName |
|
Açıklama | Ön uç geçişinin sonunda gerçekleşir: Şablon örneklemelerinde yer alan her tür için bir kez. Anahtar, türün sayısal tanımlayıcısı, ad ise metin gösterimidir. Tür anahtarları analiz edilen izleme içinde benzersizdir. Ancak, farklı derleyici ön uç geçişlerinden gelen farklı anahtarlar aynı türe işaret edebilir. Farklı derleyici ön uç geçişleri arasındaki türleri karşılaştırmak için adlarının kullanılması gerekir. SYMBOL_NAME olayları, tüm şablon örneklemeleri gerçekleştikten sonra bir derleyici ön uç geçişinin sonunda yayılır. | |
TEMPLATE_INSTANTIATION | Tür | Etkinlik |
Üst Öğeler | C1_DLL FRONT_END_FILE TEMPLATE_INSTANTIATION |
|
Alt Öğeler | TEMPLATE_INSTANTIATION | |
Properties | - Özelleştirilmiş türün anahtarı - Birincil şablonun türünün anahtarı - Örnek alınan şablon türü |
|
Yakalama sınıfları | Etkinlik TemplateInstantiation |
|
Açıklama | Şablon örneklemesinin başında ve sonunda gerçekleşir. Birincil şablon türü (örneğin vector ) örneği oluşturulur ve özel bir türe (örneğin std::vector<int> ) neden olur. Her iki tür için de bir anahtar verilir. Bir anahtarı türün adına dönüştürmek için SYMBOL_NAME olayını kullanın. Tür anahtarları analiz edilen izleme içinde benzersizdir. Ancak, farklı derleyici ön uç geçişlerinden gelen farklı anahtarlar aynı türe işaret edebilir. Farklı derleyici ön uç geçişleri arasındaki türlerin karşılaştırılması için sembol adlarının kullanılması gerekir. Bu olay özyinelemeli. Özyineleme, bazı durumlarda ön uç iç içe şablonların örneğini oluştururken gerçekleşir. |
|
İPLİK | Tür | Etkinlik |
Üst Öğeler | CODE_GENERATION TOP_DOWN |
|
Alt Öğeler | FUNCTION | |
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik İplik |
|
Açıklama | Derleyici arka uç iş parçacığı yürütmesinin başında ve sonunda gerçekleşir. Askıya alınan bir iş parçacığının sona ermiş olduğu kabul edilir. Uyandırılan bir iş parçacığının başlatıldığı kabul edilir. | |
TOP_DOWN | Tür | Etkinlik |
Üst Öğeler | WHOLE_PROGRAM_ANALYSIS | |
Alt Öğeler | FUNCTION İPLİK |
|
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik TopDown |
|
Açıklama | Tüm program analizinin yukarıdan aşağı geçişinin başlangıcında ve durdurulmasında gerçekleşir. | |
TRANSLATION_UNIT_TYPE | Tür | Etkinlik |
Üst Öğeler | FRONT_END_PASS | |
Alt Öğeler | MODÜL HEADER_UNIT PRECOMPILED_HEADER |
|
Properties | - Çeviri biriminin türü. | |
Yakalama sınıfları | SimpleEvent TranslationUnitType |
|
Açıklama | Ön uç geçişinin başında gerçekleşir. Türü, bu geçişin bir modülü mü, üst bilgi birimini mi yoksa önceden derlenmiş üst bilgiyi mi işleyip işlemediğini belirler. | |
WHOLE_PROGRAM_ANALYSIS | Tür | Etkinlik |
Üst Öğeler | C2_DLL | |
Alt Öğeler | BOTTOM_UP TOP_DOWN |
|
Properties | Hiçbiri | |
Yakalama sınıfları | Etkinlik WholeProgramAnalysis |
|
Açıklama | Bağlantı zamanı kod oluşturma işleminin tüm program çözümleme aşamasının başlangıcında ve durdurulmasında gerçekleşir. |