DkmILEvaluationResult Class

Definition

DkmILEvaluationResult represents the result of evaluating one DkmILInstruction.

public ref class DkmILEvaluationResult
[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmILEvaluationResult
[Windows::Foundation::Metadata::WebHostHidden]
class DkmILEvaluationResult
[System.Runtime.InteropServices.Guid("892ad886-2235-9411-b588-a1da20887729")]
public class DkmILEvaluationResult
[<System.Runtime.InteropServices.Guid("892ad886-2235-9411-b588-a1da20887729")>]
type DkmILEvaluationResult = class
Public Class DkmILEvaluationResult
Inheritance
DkmILEvaluationResult
Attributes

Properties

BackingRegisterByteOffset

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.

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

BackingRegisterId

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).

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

DereferencedBytes

[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.

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

IsPseudoAddress

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.

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

ResultBytes

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

SourceId

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

Methods

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).

Applies to