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
 方法成功。
 

此方法还可以返回错误值。 有关更多详细信息 ，请参阅返回值 。

注解

此方法仅在内核模式调试中可用。

仅当目标是实时内核目标，且使用 COM 端口、1394 总线或命名管道) (以标准方式进行调试时，才能使用标志DEBUG_PHYSICAL_CACHED、DEBUG_PHYSICAL_UNCACHED和DEBUG_PHYSICAL_WRITE_COMBINED。

要求

要求 值
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

IDebugDataSpaces4

ReadPhysical

WritePhysical2