Метод IDebugDataSpaces4::GetOffsetInformation (dbgeng.h)

Статья
02/23/2024

Метод GetOffsetInformation предоставляет общие сведения об адресе в пространстве данных процесса.

Синтаксис

HRESULT GetOffsetInformation(
  [in]            ULONG   Space,
  [in]            ULONG   Which,
  [in]            ULONG64 Offset,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Параметры

[in] Space

Задает пространство данных, к которому применяется параметр Offset . Допустимые значения зависят от параметра Which .

[in] Which

Указывает, какие сведения о данных запрашиваются. Это определяет возможные значения пробела и тип данных, возвращаемых в буфере. Возможны следующие значения:

DEBUG_OFFSINFO_VIRTUAL_SOURCE

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

Значение	Описание
DEBUG_VSOURCE_INVALID	Смещение смещения недоступно в виртуальном адресном пространстве процесса. Это может означать, что адрес недопустим или что память недоступна. Например, файл аварийного дампа может содержать не всю память для процесса или ядра.
DEBUG_VSOURCE_DEBUGGEE	Виртуальная память со смещением смещения предоставляется целевым объектом.
DEBUG_VSOURCE_MAPPED_IMAGE	Подсистема отладчика считывает виртуальную память целевого объекта в смещение смещения из локального файла образа. Это часто происходит в файлах minidump, где образы модулей не включаются в файл дампа и загружаются обработчиком отладчика.

[in] Offset

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

[out, optional] Buffer

Указывает буфер для получения сведений. Тип возвращаемых данных зависит от значения Параметра. Если параметр Buffer имеет значение NULL, эти сведения не возвращаются.

[in] BufferSize

Задает размер буфера буфера в байтах.

[out, optional] InfoSize

Получает размер возвращаемой информации в байтах. Если infoSize имеет значение NULL, эти сведения не возвращаются.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

Требования

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

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