Share via

DkmScriptInstructionAddress.Create Method

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.Script
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Package:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Create a new DkmScriptInstructionAddress object instance.

public:
 static Microsoft::VisualStudio::Debugger::Script::DkmScriptInstructionAddress ^ Create(Microsoft::VisualStudio::Debugger::DkmModuleInstance ^ ModuleInstance, Microsoft::VisualStudio::Debugger::Script::DkmScriptRuntimeInstance ^ RuntimeInstance, Microsoft::VisualStudio::Debugger::Script::DkmScriptDocument ^ Document, int Revision, int StartIndex, int StatementLength, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ AdditionalData, Microsoft::VisualStudio::Debugger::DkmInstructionAddress::CPUInstruction ^ CPUInstruction);
public static Microsoft.VisualStudio.Debugger.Script.DkmScriptInstructionAddress Create (Microsoft.VisualStudio.Debugger.DkmModuleInstance ModuleInstance, Microsoft.VisualStudio.Debugger.Script.DkmScriptRuntimeInstance RuntimeInstance, Microsoft.VisualStudio.Debugger.Script.DkmScriptDocument Document, int Revision, int StartIndex, int StatementLength, System.Collections.ObjectModel.ReadOnlyCollection<byte> AdditionalData, Microsoft.VisualStudio.Debugger.DkmInstructionAddress.CPUInstruction CPUInstruction);
public static Microsoft.VisualStudio.Debugger.Script.DkmScriptInstructionAddress Create (Microsoft.VisualStudio.Debugger.DkmModuleInstance? ModuleInstance, Microsoft.VisualStudio.Debugger.Script.DkmScriptRuntimeInstance RuntimeInstance, Microsoft.VisualStudio.Debugger.Script.DkmScriptDocument Document, int Revision, int StartIndex, int StatementLength, System.Collections.ObjectModel.ReadOnlyCollection<byte>? AdditionalData, Microsoft.VisualStudio.Debugger.DkmInstructionAddress.CPUInstruction? CPUInstruction);
static member Create : Microsoft.VisualStudio.Debugger.DkmModuleInstance * Microsoft.VisualStudio.Debugger.Script.DkmScriptRuntimeInstance * Microsoft.VisualStudio.Debugger.Script.DkmScriptDocument * int * int * int * System.Collections.ObjectModel.ReadOnlyCollection<byte> * Microsoft.VisualStudio.Debugger.DkmInstructionAddress.CPUInstruction -> Microsoft.VisualStudio.Debugger.Script.DkmScriptInstructionAddress
Public Shared Function Create (ModuleInstance As DkmModuleInstance, RuntimeInstance As DkmScriptRuntimeInstance, Document As DkmScriptDocument, Revision As Integer, StartIndex As Integer, StatementLength As Integer, AdditionalData As ReadOnlyCollection(Of Byte), CPUInstruction As DkmInstructionAddress.CPUInstruction) As DkmScriptInstructionAddress

Parameters

ModuleInstance
DkmModuleInstance

[In,Optional] The module containing this address. Addresses without a module cannot have symbols (even for custom addresses). CLR addresses will always have a module. Native addresses will not have a module if either the CPU jumped to an invalid address (ex: NULL), or if the CPU is executing dynamically-emitted code.

RuntimeInstance
DkmScriptRuntimeInstance

[In] Represents a script-based execution environment executing in a target process.

Document
DkmScriptDocument

[In] Document containing this instruction.

Revision
Int32

[In] Indicates the revision number which inserted the statement represented by this object. Typically, this will be zero for non-dynamic documents.

StartIndex
Int32

[In] Indicates the starting character index of this statement, relative to the start of revision which inserted this statement.

StatementLength
Int32

[In] Length of the statement (in characters).

AdditionalData
ReadOnlyCollection<Byte>

[In,Optional] Additional runtime-specific data associated with an address. This data will not be used when comparing addresses.

CPUInstruction
DkmInstructionAddress.CPUInstruction

[In,Optional] CPUInstruction provides the address that the CPU will execute. This is always provided for native instructions. It may be provided for CLR or custom addresses depending on how the address object was created.

Returns

DkmScriptInstructionAddress

[Out] Result of this method call.

Applies to