Share via

DkmCustomInstructionAddress.Create Method

  • Reference

Definition

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

Create a new DkmCustomInstructionAddress object instance.

public:
 static Microsoft::VisualStudio::Debugger::CustomRuntimes::DkmCustomInstructionAddress ^ Create(Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ RuntimeInstance, Microsoft::VisualStudio::Debugger::CustomRuntimes::DkmCustomModuleInstance ^ ModuleInstance, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ EntityId, System::UInt64 Offset, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ AdditionalData, Microsoft::VisualStudio::Debugger::DkmInstructionAddress::CPUInstruction ^ CPUInstruction);
public static Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomInstructionAddress Create (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance, Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomModuleInstance ModuleInstance, System.Collections.ObjectModel.ReadOnlyCollection<byte> EntityId, ulong Offset, System.Collections.ObjectModel.ReadOnlyCollection<byte> AdditionalData, Microsoft.VisualStudio.Debugger.DkmInstructionAddress.CPUInstruction CPUInstruction);
public static Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomInstructionAddress Create (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance, Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomModuleInstance ModuleInstance, System.Collections.ObjectModel.ReadOnlyCollection<byte>? EntityId, ulong Offset, System.Collections.ObjectModel.ReadOnlyCollection<byte>? AdditionalData, Microsoft.VisualStudio.Debugger.DkmInstructionAddress.CPUInstruction? CPUInstruction);
static member Create : Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomModuleInstance * System.Collections.ObjectModel.ReadOnlyCollection<byte> * uint64 * System.Collections.ObjectModel.ReadOnlyCollection<byte> * Microsoft.VisualStudio.Debugger.DkmInstructionAddress.CPUInstruction -> Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomInstructionAddress
Public Shared Function Create (RuntimeInstance As DkmRuntimeInstance, ModuleInstance As DkmCustomModuleInstance, EntityId As ReadOnlyCollection(Of Byte), Offset As ULong, AdditionalData As ReadOnlyCollection(Of Byte), CPUInstruction As DkmInstructionAddress.CPUInstruction) As DkmCustomInstructionAddress

Parameters

RuntimeInstance
DkmRuntimeInstance

[In] The DkmRuntimeInstance class represents an execution environment which is loaded into a DkmProcess and which contains code to be debugged.

ModuleInstance
DkmCustomModuleInstance

[In] The module containing the InstructionPointer.

EntityId
ReadOnlyCollection<Byte>

[In,Optional] This is a runtime-specific data structure which custom runtimes may use to store the location of this instruction. Along with 'offset', this field will used to compare two instructions from the same module.

Offset
UInt64

[In] Along with 'EntityId' the 'Offset' field is used to uniquely identity an instruction. This could hold a pointer value (such as a pointer to the instruction) or an offset from the start of the function/module.

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

DkmCustomInstructionAddress

[Out] Result of this method call.

Applies to