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

Статья
06.02.2025

Метод 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 (include Dbgeng.h)

См. также

IDebugDataSpaces4

ReadPhysical

WritePhysical2

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