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

  • Статья

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

Синтаксис

HRESULT ReadPhysical2(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Параметры

[in] Offset

Указывает физический адрес считываемой памяти.

[in] Flags

Указывает свойства физической памяти для чтения. Это должно соответствовать способу объявления физической памяти операционной системе на целевом объекте. Возможные значения перечислены в следующей таблице.

Значение Описание
DEBUG_PHYSICAL_DEFAULT Используйте кэширование памяти по умолчанию.
DEBUG_PHYSICAL_CACHED Физическая память кэшируется.
DEBUG_PHYSICAL_UNCACHED Физическая память не кешируется.
DEBUG_PHYSICAL_WRITE_COMBINED Физическая память объединяется с записью.

[out] Buffer

Получает считываемую память.

[in] BufferSize

Указывает размер буфера буфера буфера (в байтах). Это максимальное число байтов, которые будут считаны.

[out, optional] BytesRead

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

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

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

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

Комментарии

Этот метод доступен только в отладке в режиме ядра.

Флаги DEBUG_PHYSICAL_CACHED, DEBUG_PHYSICAL_UNCACHED и DEBUG_PHYSICAL_WRITE_COMBINED можно использовать только в том случае, если целевой объект является целевым объектом ядра, который отлаживается стандартным способом (с помощью COM-порта, шины 1394 или именованного канала).

Требования

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

См. также раздел

IDebugDataSpaces4

Чтение Физическое

WritePhysical2