Edit

Share via

IDebugDataSpaces4::WritePhysical2 method (dbgeng.h)

  • Article

The WritePhysical2 method writes data to the specified physical address in the target's memory.

Syntax

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

Parameters

[in] Offset

Specifies the physical address of the memory to write the data to.

[in] Flags

Specifies the properties of the physical memory to be written to. This must match the way the physical memory was advertised to the operating system on the target. Possible values are listed in the following table.

Value Description
DEBUG_PHYSICAL_DEFAULT Use the default memory caching.
DEBUG_PHYSICAL_CACHED The physical memory is cached.
DEBUG_PHYSICAL_UNCACHED The physical memory is uncached.
DEBUG_PHYSICAL_WRITE_COMBINED The physical memory is write-combined.

[in] Buffer

Specifies the data to write.

[in] BufferSize

Specifies the size, in bytes, of the Buffer buffer. This is the maximum number of bytes that will be written.

[out, optional] BytesWritten

Receives the number of bytes written to the target's memory. If BytesWritten is NULL, this information is not returned.

Return value

This method can also return error values. See Return Values for more details.

Return code Description
S_OK
 The method was successful.

Remarks

This method is only available in kernel-mode debugging.

The flags DEBUG_PHYSICAL_CACHED, DEBUG_PHYSICAL_UNCACHED, and DEBUG_PHYSICAL_WRITE_COMBINED can only be used when the target is a live kernel target that is being debugged in the standard way (using a COM port, 1394 bus, or named pipe).

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)

See also

IDebugDataSpaces4

WritePhysical

WritePhysical2