DkmILEvaluationResult.Create Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Evaluation.IL

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Overloads

Create(Guid, ReadOnlyCollection<Byte>)	Create a new DkmILEvaluationResult object instance.
Create(Guid, ReadOnlyCollection<Byte>, Boolean, ReadOnlyCollection<Byte>)	Create a new DkmILEvaluationResult object instance. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Create(Guid, ReadOnlyCollection<Byte>, Boolean, ReadOnlyCollection<Byte>, Int32, Int32)	Create a new DkmILEvaluationResult object instance. This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

Create(Guid, ReadOnlyCollection<Byte>)

Create a new DkmILEvaluationResult object instance.

public:
 static Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILEvaluationResult ^ Create(Guid SourceId, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ ResultBytes);

public static Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILEvaluationResult Create (Guid SourceId, System.Collections.ObjectModel.ReadOnlyCollection<byte> ResultBytes);

static member Create : Guid * System.Collections.ObjectModel.ReadOnlyCollection<byte> -> Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILEvaluationResult

Public Shared Function Create (SourceId As Guid, ResultBytes As ReadOnlyCollection(Of Byte)) As DkmILEvaluationResult

Parameters

SourceId

Guid

[In] UniqueId of the DkmILInstruction object that originally pushed the returned value onto the evaluation stack.

ResultBytes

ReadOnlyCollection<Byte>

[In] The results of evaluating the DkmILInstruction. Empty for pseudo-addresses.

Returns

DkmILEvaluationResult

[Out] Result of this method call.

Create(Guid, ReadOnlyCollection<Byte>, Boolean, ReadOnlyCollection<Byte>)

Create a new DkmILEvaluationResult object instance.

This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

public:
 static Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILEvaluationResult ^ Create(Guid SourceId, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ ResultBytes, bool IsPseudoAddress, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ DereferencedBytes);

public static Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILEvaluationResult Create (Guid SourceId, System.Collections.ObjectModel.ReadOnlyCollection<byte> ResultBytes, bool IsPseudoAddress, System.Collections.ObjectModel.ReadOnlyCollection<byte>? DereferencedBytes);

static member Create : Guid * System.Collections.ObjectModel.ReadOnlyCollection<byte> * bool * System.Collections.ObjectModel.ReadOnlyCollection<byte> -> Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILEvaluationResult

Public Shared Function Create (SourceId As Guid, ResultBytes As ReadOnlyCollection(Of Byte), IsPseudoAddress As Boolean, DereferencedBytes As ReadOnlyCollection(Of Byte)) As DkmILEvaluationResult

Parameters

SourceId

Guid

[In] UniqueId of the DkmILInstruction object that originally pushed the returned value onto the evaluation stack.

ResultBytes

ReadOnlyCollection<Byte>

[In] The results of evaluating the DkmILInstruction. Empty for pseudo-addresses.

IsPseudoAddress

Boolean

[In] If true, indicates that the IL result is a pseudo-address, rather than an actual value. The ResultBytes property of a pseudo-address will be the bytes of the local variable that the pseudo-address refers to, excluding any bytes prior to the offset of the pseudo-address. The ResultBytes property of a pseudo-address will be empty if the backing local variable does not exist, is another pseudo-address, or is capturing fewer bytes than the byte offset of the current pseudo-address. For details on pseudo-addresses, see the DkmILPushLocalVariablePseudoAddress function.

DereferencedBytes

ReadOnlyCollection<Byte>

[In,Optional] If IsPseudoAddress is true, specifies the contents of the backing data for the pseudo-address. This will be NULL if the backing local variable does not exist, is another pseudo-address, or contains fewer bytes than the offset of the pseudo-address.

Returns

DkmILEvaluationResult

[Out] Result of this method call.

Create(Guid, ReadOnlyCollection<Byte>, Boolean, ReadOnlyCollection<Byte>, Int32, Int32)

Create a new DkmILEvaluationResult object instance.

This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

public:
 static Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILEvaluationResult ^ Create(Guid SourceId, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ ResultBytes, bool IsPseudoAddress, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ DereferencedBytes, int BackingRegisterId, int BackingRegisterByteOffset);

public static Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILEvaluationResult Create (Guid SourceId, System.Collections.ObjectModel.ReadOnlyCollection<byte> ResultBytes, bool IsPseudoAddress, System.Collections.ObjectModel.ReadOnlyCollection<byte>? DereferencedBytes, int BackingRegisterId, int BackingRegisterByteOffset);

static member Create : Guid * System.Collections.ObjectModel.ReadOnlyCollection<byte> * bool * System.Collections.ObjectModel.ReadOnlyCollection<byte> * int * int -> Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILEvaluationResult

Public Shared Function Create (SourceId As Guid, ResultBytes As ReadOnlyCollection(Of Byte), IsPseudoAddress As Boolean, DereferencedBytes As ReadOnlyCollection(Of Byte), BackingRegisterId As Integer, BackingRegisterByteOffset As Integer) As DkmILEvaluationResult

Parameters

SourceId

Guid

[In] UniqueId of the DkmILInstruction object that originally pushed the returned value onto the evaluation stack.

ResultBytes

ReadOnlyCollection<Byte>

[In] The results of evaluating the DkmILInstruction. Empty for pseudo-addresses.

IsPseudoAddress

Boolean

[In] If true, indicates that the IL result is a pseudo-address, rather than an actual value. The ResultBytes property of a pseudo-address will be the bytes of the local variable that the pseudo-address refers to, excluding any bytes prior to the offset of the pseudo-address. The ResultBytes property of a pseudo-address will be empty if the backing local variable does not exist, is another pseudo-address, or is capturing fewer bytes than the byte offset of the current pseudo-address. For details on pseudo-addresses, see the DkmILPushLocalVariablePseudoAddress function.

DereferencedBytes

ReadOnlyCollection<Byte>

[In,Optional] If IsPseudoAddress is true, specifies the contents of the backing data for the pseudo-address. This will be NULL if the backing local variable does not exist, is another pseudo-address, or contains fewer bytes than the offset of the pseudo-address.

BackingRegisterId

Int32

[In] If this evaluation result represents the pseudo-address of somewhere within a register (pushed onto the stack with a DkmILPushRegisterPseudoAddress instruction), returns the register that backs the result. If no backing register exists, the return value is 0 (CV_REG_NONE).

BackingRegisterByteOffset

Int32

[In] If this evaluation result represents the pseudo-address of somewhere within a register (pushed onto the stack with a DkmILPushRegisterPseudoAddress instruction), returns the byte offset within the register that this pseudo-address represents. If no backing register exists, the return value is zero. This property is valid only if BackingRegisterId() returns a nonzero value.

Returns

DkmILEvaluationResult

[Out] Result of this method call.