DkmGPUComputeThread.ReadMemory Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.GPU

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Overloads

ReadMemory(UInt64, UInt64, DkmReadMemoryFlags, Byte[])	Read the memory of the target GPU process. The method is on DkmGPUComputeThread because it may read thread local memory, group shared memory or global memory.
ReadMemory(UInt64, UInt64, DkmReadMemoryFlags, Void*, Int32)	Read the memory of the target GPU process. The method is on DkmGPUComputeThread because it may read thread local memory, group shared memory or global memory.

ReadMemory(UInt64, UInt64, DkmReadMemoryFlags, Byte[])

Read the memory of the target GPU process. The method is on DkmGPUComputeThread because it may read thread local memory, group shared memory or global memory.

public:
 int ReadMemory(System::UInt64 Address, System::UInt64 InstructionPointer, Microsoft::VisualStudio::Debugger::DkmReadMemoryFlags Flags, cli::array <System::Byte> ^ Buffer);

public:
 int ReadMemory(unsigned long long Address, unsigned long long InstructionPointer, Microsoft::VisualStudio::Debugger::DkmReadMemoryFlags Flags, Platform::Array <byte> ^ Buffer);

int ReadMemory(unsigned long Address, unsigned long InstructionPointer, Microsoft::VisualStudio::Debugger::DkmReadMemoryFlags Flags, std::Array <byte> const & Buffer);

public int ReadMemory (ulong Address, ulong InstructionPointer, Microsoft.VisualStudio.Debugger.DkmReadMemoryFlags Flags, byte[] Buffer);

member this.ReadMemory : uint64 * uint64 * Microsoft.VisualStudio.Debugger.DkmReadMemoryFlags * byte[] -> int

Public Function ReadMemory (Address As ULong, InstructionPointer As ULong, Flags As DkmReadMemoryFlags, Buffer As Byte()) As Integer

Parameters

Address

UInt64

[In] The address from which to read the target GPU process's memory.

InstructionPointer

UInt64

[In] The instruction pointer where to resolve address to register location.

Flags

DkmReadMemoryFlags

[In] Flags controlling the behavior of DkmProcess.ReadMemory and DkmProcess.ReadMemoryString.

Buffer

Byte[]

[In,Out] A buffer that receives the contents from the address space of the target process. On failure, the content of this buffer is unspecified.

Returns

Int32

[Out] Indicates the number of bytes read from the target GPU process. If DkmReadMemoryFlags.AllowPartialRead is clear, on success this value will always be exactly equal to the input size. If DkmReadMemoryFlags.AllowPartialRead is specified, on success, this value will be greater than zero.

ReadMemory(UInt64, UInt64, DkmReadMemoryFlags, Void*, Int32)

Read the memory of the target GPU process. The method is on DkmGPUComputeThread because it may read thread local memory, group shared memory or global memory.

public:
 int ReadMemory(System::UInt64 Address, System::UInt64 InstructionPointer, Microsoft::VisualStudio::Debugger::DkmReadMemoryFlags Flags, void* Buffer, int Size);

int ReadMemory(unsigned long Address, unsigned long InstructionPointer, Microsoft::VisualStudio::Debugger::DkmReadMemoryFlags Flags, void* Buffer, int Size);

public int ReadMemory (ulong Address, ulong InstructionPointer, Microsoft.VisualStudio.Debugger.DkmReadMemoryFlags Flags, void* Buffer, int Size);

member this.ReadMemory : uint64 * uint64 * Microsoft.VisualStudio.Debugger.DkmReadMemoryFlags * nativeptr<unit> * int -> int

Parameters

Address

UInt64

[In] The address from which to read the target GPU process's memory.

InstructionPointer

UInt64

[In] The instruction pointer where to resolve address to register location.

Flags

DkmReadMemoryFlags

[In] Flags controlling the behavior of DkmProcess.ReadMemory and DkmProcess.ReadMemoryString.

Buffer

Void*

[In,Out] A buffer that receives the contents from the address space of the target process. On failure, the content of this buffer is unspecified.

Size

Int32

[In] The number of bytes to be read from the process. In scenarios where the call is marshalled to the remote debugger from the IDE, this must be less than 25 MBs.

Returns

Int32

[Out] Indicates the number of bytes read from the target GPU process. If DkmReadMemoryFlags.AllowPartialRead is clear, on success this value will always be exactly equal to the input size. If DkmReadMemoryFlags.AllowPartialRead is specified, on success, this value will be greater than zero.