IDebugDataSpaces4::WritePhysical2 方法 (dbgeng.h)

WritePhysical2 方法會將數據寫入目標記憶體中指定的實體位址。

語法

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

參數

[in] Offset

指定要將數據寫入的記憶體實體位址。

[in] Flags

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

Description
DEBUG_PHYSICAL_DEFAULT 使用預設記憶體快取。
DEBUG_PHYSICAL_CACHED 已快取實體記憶體。
DEBUG_PHYSICAL_UNCACHED 未快取實體記憶體。
DEBUG_PHYSICAL_WRITE_COMBINED 實體記憶體會合併寫入。

[in] Buffer

指定要寫入的數據。

[in] BufferSize

指定 緩衝區 緩衝區的大小,以位元組為單位。 這是將寫入的最大位元元組數目。

[out, optional] BytesWritten

接收寫入目標記憶體的位元組數目。 如果 BytesWrittenNULL,則不會傳回這項資訊。

傳回值

這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值

傳回碼 描述
S_OK
此方法成功。

備註

這個方法僅適用於內核模式偵錯。

只有在目標是以標準方式偵錯的即時核心目標時,才能使用旗標DEBUG_PHYSICAL_CACHED、DEBUG_PHYSICAL_UNCACHED和DEBUG_PHYSICAL_WRITE_COMBINED, (使用 COM 埠、1394 總線或命名管道) 。

規格需求

需求
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

IDebugDataSpaces4

WritePhysical

WritePhysical2