使用源文件

调试器引擎维护源路径,该路径是包含与当前目标关联的源代码文件的目录和源服务器的列表。 调试器引擎可以在这些目录和源服务器中搜索源文件。 借助符号文件,调试器引擎可以将源文件中的行与目标内存中的位置进行匹配。

有关将源文件与调试器配合使用的概述,请参阅 在源模式下调试。 有关源路径的概述,请参阅 源路径。 有关从调试器引擎使用源服务器的概述,请参阅 使用源服务器

源路径

若要将目录或源服务器添加到源路径,请使用 AppendSourcePath 方法。 整个源路径由 GetSourcePath 返回,可以使用 SetSourcePath 进行更改。 可以使用 GetSourcePathElement 从源路径检索单个目录或源服务器。

若要查找相对于源路径的源文件,请使用 FindSourceFile ;对于使用源服务器时更高级的选项,请使用 FindSourceFileAndTokenFindSourceFileAndToken 还可以与 GetSourceFileInformation 一起使用,以检索与源服务器上的文件相关的变量。

将源文件与内存中的代码匹配

调试器引擎提供了三种方法,用于查找与源文件中的行对应的内存位置。 若要将单行源代码映射到内存位置,请使用 GetOffsetByLine。 若要搜索多个源行或附近源行的内存位置,请使用 GetSourceEntriesByLineGetSourceFileLineOffsets 方法将返回源文件中每一行的内存位置。

若要执行相反的操作并查找与目标内存中某个位置匹配的源文件行,请使用 GetLineByOffset

注意 内存位置与源文件中的行之间的关系不一定是一对一的。 单个源代码行可以对应于多个内存位置,而单个内存位置可以对应于多行源代码。