ExtRemoteData::ReadBuffer method (engextcpp.hpp)

The ReadBuffer method reads data from the target's memory. The data is located in the beginning of the region represented by the ExtRemoteData object. However, the size of the data can be different.

Syntax

ULONG ReadBuffer(
  [out] PVOID Buffer,
  [in]  ULONG Bytes,
  [in]  bool  MustReadAll
);

Parameters

[out] Buffer

Pointer that receives the data read from the target.

[in] Bytes

Specifies the number of bytes to read. The Buffer buffer must be at least this size.

[in] MustReadAll

Specifies what happens if the debugger engine is unable to read all the data from the target. If MustReadAll is true and the debugger engine is unable to read Bytes bytes from the target, an ExtRemoteException will be thrown. If MustReadAll is false, no exception will be thrown if the engine is unable to read the requested number of bytes from the target.

Return value

ReadBuffer returns the number of bytes read from the target and copied into the Buffer buffer. If MustReadAll is true, the value of Bytes will be returned (unless an exception is thrown).

Requirements

Requirement Value
Target Platform Desktop
Header engextcpp.hpp (include Engextcpp.hpp)

See also

ExtRemoteData

ExtRemoteData::WriteBuffer