WriteVirtualUncached

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

HRESULT
  IDebugDataSpaces::WriteVirtualUncached(
    IN ULONG64  Offset,
    IN PVOID  Buffer,
    IN ULONG  BufferSize,
    OUT OPTIONAL PULONG  BytesWritten
    );

Parameters

Offset

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

Buffer

Specifies the buffer to write the memory from.

BufferSize

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

BytesWritten

Receives the number of bytes that were actually written. If it is set to NULL, this information is not returned.

Return Value

S_OK

The method was at least partially successful. BytesWritten indicates the number of bytes successfully written, which may be less than BufferSize.

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

Interface Version

WriteVirtualUncached is available in all versions of IDebugDataSpaces.

Comments

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

This method behaves identically to WriteVirtual, except that it avoids using the virtual memory cache. It is therefore useful for reading inherently volatile virtual memory, such as memory-mapped device areas, without contaminating or invalidating the cache.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

WriteVirtual, ReadVirtualUncached