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

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

  • Статья

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

Синтаксис

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCWSTR  ModuleName,
  [in, optional] PCWSTR  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 установлен в маске, возвращаемой методом IDebugEventCallbacksWide::GetInterestMask.

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

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

Требования

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