使用原始程式檔

偵錯工具引擎會維護來源路徑,這是目錄和來源伺服器的清單,其中包含與目前目標相關聯的原始程式碼檔案。 偵錯工具引擎可以搜尋這些目錄和來源伺服器中的來源檔案。 偵錯工具引擎可以使用符號檔的協助,比對來源檔案中的行與目標記憶體中的位置。

如需搭配偵錯工具使用來源檔案的概觀,請參閱 在來源模式中偵錯。 如需來源路徑的概觀,請參閱 來源路徑。 如需從偵錯工具引擎使用來源伺服器的概觀,請參閱 使用來源伺服器

來源路徑

若要將目錄或來源伺服器新增至來源路徑,請使用 AppendSourcePath方法。 GetSourcePath會傳回整個來源路徑,而且可以使用SetSourcePath來變更。 您可以使用 GetSourcePathElement從來源路徑擷取單一目錄或來源伺服器。

若要尋找來源檔案相對於來源路徑,請使用 FindSourceFile ,或者,在使用來源伺服器時,如需更進階的選項,請使用 FindSourceFileAndTokenFindSourceFileAndToken 也可以與 GetSourceFileInformation 搭配使用,以擷取與來源伺服器上檔案相關的變數。

比對原始程式碼與記憶體中的程式碼

偵錯工具引擎提供三種方法來尋找對應至來源檔案中行的記憶體位置。 若要將單行原始程式碼對應至記憶體位置,請使用 GetOffsetByLine。 若要搜尋多個來源行或附近來源行的記憶體位置,請使用 GetSourceEntriesByLineGetSourceFileLineOffsets方法會傳回來源檔案中每一行的記憶體位置。

若要執行相反的作業,並尋找符合目標記憶體中位置的來源檔案行,請使用 GetLineByOffset

注意 來源檔案中記憶體位置和行之間的關聯性不一定是一對一。 單行原始程式碼可以對應至多個記憶體位置,以及單一記憶體位置對應至多行原始程式碼。