Korzystanie z plików źródłowych

Aparat debugera utrzymuje ścieżkę źródłową, która jest listą katalogów i serwerów źródłowych, które zawierają pliki kodu źródłowego skojarzone z bieżącymi elementami docelowymi. Aparat debugera może przeszukiwać te katalogi i serwery źródłowe dla plików źródłowych. Za pomocą plików symboli silnik debugera może dopasowywać wiersze w plikach źródłowych do lokalizacji w pamięci celu.

Aby zapoznać się z omówieniem używania plików źródłowych z debugerami, zobacz Debugowanie w trybie źródłowym. Aby zapoznać się z omówieniem ścieżek źródłowych, zobacz Ścieżka źródłowa. Aby zapoznać się z omówieniem korzystania z serwerów źródłowych z silnika debugera, zobacz Używanie serwera źródłowego.

Ścieżka źródłowa

Aby dodać katalog lub serwer źródłowy do ścieżki źródłowej, użyj metody AppendSourcePath. Cała ścieżka źródłowa jest zwracana przez metodę GetSourcePath i może zostać zmieniona przy użyciu metody SetSourcePath. Pojedynczy katalog lub serwer źródłowy można pobrać ze ścieżki źródłowej przy użyciu elementu GetSourcePathElement.

Aby znaleźć plik źródłowy względem ścieżki źródłowej, użyj polecenia FindSourceFile lub, aby uzyskać bardziej zaawansowane opcje podczas korzystania z serwerów źródłowych, użyj polecenia FindSourceFileAndToken. Można również użyć polecenia FindSourceFileAndToken wraz z poleceniem GetSourceFileInformation w celu pobrania zmiennych powiązanych z plikiem na serwerze źródłowym.

Dopasowywanie plików źródłowych do kodu w pamięci

Aparat debugera udostępnia trzy metody lokalizowania lokalizacji pamięci odpowiadających wierszom w pliku źródłowym. Aby zamapować pojedynczy wiersz kodu źródłowego na lokalizację pamięci, użyj polecenia GetOffsetByLine. Aby wyszukać lokalizacje pamięci dla więcej niż jednego wiersza źródłowego lub dla pobliskich wierszy źródłowych, użyj polecenia GetSourceEntriesByLine. Metoda GetSourceFileLineOffsets zwróci lokalizację pamięci każdego wiersza w pliku źródłowym.

Aby wykonać odwrotną operację i znaleźć wiersz pliku źródłowego pasujący do lokalizacji w pamięci obiektu docelowego, użyj polecenia GetLineByOffset.

Uwaga Relacja między lokalizacjami pamięci a wierszami w pliku źródłowym nie musi być relacją jeden do jednego. Istnieje możliwość, aby pojedynczy wiersz kodu źródłowego odpowiadał wielu lokalizacjom pamięci i pojedynczej lokalizacji pamięci odpowiadającym wielu wierszom kodu źródłowego.