Поделиться через

Метод IDebugEventCallbacks::LoadModule (dbgeng.h)

  • Статья

Метод обратного вызова LoadModule вызывается подсистемой при возникновении события отладки загрузки модуля в целевом объекте.

Синтаксис

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCSTR   ModuleName,
  [in, optional] PCSTR   ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp
);

Параметры

[in] ImageFileHandle

Указывает дескриптор файла изображения модуля. Если эти сведения недоступны, ImageFileHandle будет иметь значение NULL.

[in] BaseOffset

Указывает базовый адрес модуля в адресном пространстве целевой памяти. Если эти сведения недоступны, baseOffset будет иметь значение NULL.

[in] ModuleSize

Указывает размер изображения модуля в байтах. Если эти сведения недоступны, Значение ModuleSize будет иметь значение NULL.

[in, optional] ModuleName

Указывает упрощенное имя модуля, используемое подсистемой отладчика. В большинстве случаев это соответствует имени файла образа, за исключением расширения. Если эти сведения недоступны, moduleName будет иметь значение NULL.

[in, optional] ImageName

Указывает имя файла изображения модуля, которое может включать путь. Если эти сведения недоступны, ImageName будет иметь значение NULL.

[in] CheckSum

Указывает контрольную сумму файла изображения модуля. Если эти сведения недоступны, CheckSum будет иметь значение NULL.

[in] TimeDateStamp

Указывает метку времени и даты файла изображения модуля. Если эти сведения недоступны, timeDateStamp будет равен нулю.

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

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

Комментарии

Этот метод вызывается подсистемой, только если флаг DEBUG_EVENT_LOAD_MODULE установлен в маске, возвращаемой IDebugEventCallbacks::GetInterestMask.

После вызова этого метода подсистема вызовет IDebugEventCallbacks::ChangeSymbolState с параметром Flags, содержащим битовый флаг DEBUG_CSS_LOADS.

Дополнительные сведения об обработке событий см. в разделе События мониторинга.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)