DkmILMemoryStringRead Class

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.Evaluation.IL
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll

A request to read a null-terminated string from the target process. The address to read from is popped off the DkmIL stack and must have a size of 4 if the debuggee is 32-bit, or 8 if the debuggee is 64-bit. The bytes that are read from memory are pushed onto the stack. This will include the null-terminator if this value is read. The null-terminator will be missing when DkmReadMemoryFlags.AllowPartialRead is true, and either the MaxCharacters is hit, or unreadable memory is hit before the null terminator.

public ref class DkmILMemoryStringRead : Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILInstruction
[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmILMemoryStringRead : Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILInstruction
[Windows::Foundation::Metadata::WebHostHidden]
class DkmILMemoryStringRead : Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILInstruction
[System.Runtime.InteropServices.Guid("a64d7c04-4e5a-4a75-936c-5eeeb7121f65")]
public class DkmILMemoryStringRead : Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILInstruction
[<System.Runtime.InteropServices.Guid("a64d7c04-4e5a-4a75-936c-5eeeb7121f65")>]
type DkmILMemoryStringRead = class
    inherit DkmILInstruction
Public Class DkmILMemoryStringRead
Inherits DkmILInstruction
Inheritance
Object
DkmILInstruction
DkmILMemoryStringRead
Attributes
GuidAttribute

Properties

CharacterSize

Number of bytes in each character. This should be set to 1 (ANSI/UTF-8), 2 (UTF-16) or 4 (UTF-32).
Flags

Flags controlling the behavior of DkmProcess.ReadMemory and DkmProcess.ReadMemoryString.
MaxCharacters

The maximum number of characters to read from the target process. When DkmReadMemoryFlags.AllowPartialRead is false, the request will fail if a null terminator isn't found within this range with DkmILFailureReason.StringTooLong.
TagValue

DkmILInstruction is an abstract base class. This enum indicates which derived class this object is an instance of.

(Inherited from DkmILInstruction)
UniqueId

Uniquely identifies the DkmILInstruction object. Used as a hash-table key to allow for quickly matching up DkmIL instructions with their matching values.

(Inherited from DkmILInstruction)

Methods

Create(DkmReadMemoryFlags, UInt16, Int32)

Create a new DkmILMemoryStringRead object instance.

Applies to