Debugging Tools for Windows

ReadPointersVirtual

The ReadPointersVirtual method is a convenience method for reading pointers from the target's virtual address space.

HRESULT
  IDebugDataSpaces::ReadPointersVirtual(
    IN ULONG  Count
    IN ULONG64  Offset
    OUT PULONG64  Ptrs
    );

Parameters

Count
Specifies the number of pointers to read.
Offset
Specifies the location in the target's virtual address space to start reading the pointers.
Ptrs
Specifies the array to store the pointers. The number of elements this array holds is Count.

Return Value

S_OK
All the pointers were read from the target's memory and stored in Ptrs.

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

Interface Version

ReadPointersVirtual is available in all versions of IDebugDataSpaces.

Comments

This method reads from the memory from the target's virtual address space. The memory is then treated as a list of pointers. Any 32-bit pointers are then sign-extended to 64-bit values.

Requirements

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

See Also

ReadVirtual, WritePointersVirtual

Build machine: CAPEBUILD