IDebugDataSpaces4::WriteVirtual method (dbgeng.h)

The WriteVirtual method writes data to the target's virtual address space.

Syntax

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

Parameters

[in] Offset

Specifies the location in the target's virtual address space to be written.

[in] Buffer

Specifies the buffer to write the memory from.

[in] BufferSize

Specifies the size in bytes of the buffer. This is also the number of bytes requested to be written.

[out, optional] BytesWritten

Receives the number of bytes that were written. If it is set to 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 at least partially successful. BytesWritten indicates the number of bytes successfully written, which may be less than BufferSize.

Remarks

This method writes the buffer to the memory in the target's virtual address space.

This method may only write to a cache of memory data when storing data. To avoid caching, use WriteVirtualUncached instead.

Requirements

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

See also

IDebugDataSpaces

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

ReadVirtual

WriteVirtualUncached