Sembolleri Kullanma

Sembol dosyalarını ve sembol sunucularını kullanma da dahil olmak üzere simgelere genel bakış için bkz. Simgeler.

Sembol Adları ve Konumları

Adı verilen bir simgenin konumunu bulmak için GetOffsetByName kullanın. Simge adlarını belirtmek için kullanılan söz diziminin ayrıntıları için bkz. Simge Söz Dizimi ve Simge Eşleştirme.

Bir simgenin tam adı bilinmiyorsa veya birden çok simge aynı ada sahipse, StartSymbolMatch adları belirli bir desenle eşleşen simgeler için bir arama başlatır. Söz dizimi hakkında ayrıntılı bilgi için bkz. Dize Joker Karakter Sözdizimi.

Konumu verilen bir simgenin adını bulmak için GetNameByOffset'i kullanın. Belirli bir konuma yakın bir modüldeki simgelerin adlarını bulmak için GetNearNamebyOffset kullanın.

Not Mümkün olduğunda simgeyi modül adıyla niteleyin; örneğin mymodule!main. Aksi takdirde, simge yoksa (örneğin, bir yazım hatası nedeniyle) altyapının her modül için sembolleri yüklemesi ve araması gerekir; bu, özellikle çekirdek modu hata ayıklaması için yavaş bir işlem olabilir. Sembol adı bir modül adıyla nitelenmişse, altyapının yalnızca bu modülün simgelerini araması gerekir.

Bir simge, yapı DEBUG_MODULE_AND_ID kullanılarak benzersiz olarak tanımlanır. Bu yapı, sırasıyla adlarına ve konumlarına göre simgeleri arayan GetSymbolEntriesByName ve GetSymbolEntriesByOffset yöntemleri tarafından döndürülür.

GetSymbolEntryInformation yöntemi, DEBUG_SYMBOL_ENTRY yapısını kullanan bir simgenin açıklamasını döndürür.

Bir yapı içindeki alanın uzaklığını bulmak için GetFieldOffset kullanın. Bir yapı içinde dizini verilen bir alanın adını bulmak için GetFieldName kullanın. Değeri verilen bir numaralandırma sabitinin adını bulmak için GetConstantName kullanın.

GetSymbolInformation yöntemi semboller hakkında bilgi için çeşitli istekler gerçekleştirebilir.

Simge Seçenekleri

Bir dizi seçenek, simgelerin nasıl yüklendiğini ve kaldırılıp kaldırılamını denetler. Bu seçeneklerin açıklaması için bkz. Simge Seçeneklerini Ayarlama.

Simge seçenekleri AddSymbolOptions kullanılarak ve RemoveSymbolOptions kullanılarak kapatılabilir.

GetSymbolOptions geçerli simge seçeneklerini döndürür. Tüm simge seçeneklerini aynı anda ayarlamak için SetSymbolOptions kullanın.

Sembolleri Yeniden Yükleme

Sembol dosyalarını yükledikten sonra altyapı, simge bilgilerini bir iç önbellekte depolar. Bu önbelleği temizlemek için Yeniden Yükle'yi kullanın. Bu simgelerin şimdi veya daha sonra yeniden yüklenmesi gerekir.

Sentetik Simgeler

Yapay simgeler , kolay başvuru için rastgele bir adresi etiketlemenin bir yoludur. Yapay simgeler mevcut herhangi bir modülde oluşturulabilir. AddSyntheticSymbol yöntemi yeni bir sentetik simge oluşturur. Sentetik simgeler RemoveSyntheticSymbol kullanılarak kaldırılabilir. Modülün sembollerinin yeniden yüklenmesi, bu modülle ilişkili tüm yapay simgeleri siler.

Sembol Yolu

Simge yoluna bir dizin veya sembol sunucusu eklemek için AppendSymbolPath yöntemini kullanın. Sembol yolunun tamamı GetSymbolPath tarafından döndürülür ve SetSymbolPath kullanılarak değiştirilebilir.