Метод IDebugSymbols3::GetModuleByOffset (dbgeng.h)

Метод GetModuleByOffset выполняет поиск по модулям целевого объекта, для одного, выделение памяти которого включает указанное расположение.

Синтаксис

HRESULT GetModuleByOffset(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Параметры

[in] Offset

Указывает расположение в виртуальном адресном пространстве целевого объекта, которое находится внутри выделения памяти требуемого модуля, например адрес символа, относящегося к модулю.

[in] StartIndex

Указывает индекс для начала поиска.

[out, optional] Index

Получает индекс модуля. Если индексnull, эти сведения не возвращаются.

[out, optional] Base

Получает расположение в адресном пространстве памяти целевого объекта базы модуля. Если базовыйзначение NULL, эти сведения не возвращаются.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Замечания

Начиная с указанного индекса, этот метод возвращает первый модуль, который он находит, диапазон адресов выделения памяти которого включает указанное расположение. Если целевой объект имеет несколько модулей, диапазон адресов памяти которого включает это расположение, последующие модули можно найти путем повторных вызовов этого метода с более высокими значениями StartIndex.

Дополнительные сведения о модулях см. в модулях.

Требования

См. также

GetModuleByIndex

GetModuleByOffset2

IDebugSymbols

IDebugSymbols2

IDebugSymbols3