(dbgeng.h) IDebugDataSpaces4：：ReadPhysical2 方法

  • 發行項

ReadPhysical2 方法會從指定的實體位址讀取目標的記憶體。

語法

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

參數

[in] Offset

指定要讀取之內存的實體位址。

[in] Flags

指定要讀取之物理記憶體的屬性。 這必須符合實體記憶體在目標上公告至操作系統的方式。 下表列出可能的值。

值 Description
DEBUG_PHYSICAL_DEFAULT 使用預設記憶體快取。
DEBUG_PHYSICAL_CACHED 系統會快取物理記憶體。
DEBUG_PHYSICAL_UNCACHED 未快取物理記憶體。
DEBUG_PHYSICAL_WRITE_COMBINED 物理記憶體會合併寫入。

[out] Buffer

接收讀取的記憶體。

[in] BufferSize

指定 Buffer 緩衝區的大小，以位元組為單位。 這是將讀取的最大位元元組數目。

[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