ReadTypedDataVirtual

The ReadTypedDataVirtual method reads the value of a variable in the target's virtual memory.

HRESULT
  IDebugSymbols::ReadTypedDataVirtual(
    IN ULONG64  Offset,
    IN ULONG64  Module,
    IN ULONG  TypeId,
    OUT PVOID  Buffer,
    IN ULONG  BufferSize,
    OUT OPTIONAL PULONG  BytesRead
    );

Parameters

Offset

Specifies the location in the target's virtual address space of the variable to read.

Module

Specifies the base address of the module containing the type of the variable.

TypeId

Specifies the type ID of the type.

Buffer

Receives the data that is read.

BufferSize

Specifies the size in bytes of the buffer Buffer. This is the maximum number of bytes to be read.

BytesRead

Receives the number of bytes that were read. If BytesRead is NULL, this information is not returned.

Return Value

S_OK

The method was successful.

S_FALSE

The method was successful. However, the buffer Buffer was not large enough to hold all the data and it was truncated.

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

Interface Version

ReadTypedDataVirtual is available in all versions of IDebugSymbols.

Comments

The number of bytes this method attempts to read is the smaller of the size of the buffer and the size of the variable.

This is a convenience method. The same result can be obtained by calling GetTypeSize and ReadVirtual.

For more information about types, see Types.

Requirements

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