Share via

DkmClrNcInstructionSymbol.Create Method

  • Reference

Definition

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

Create a new DkmClrNcInstructionSymbol object instance.

This API was introduced in Visual Studio 15 Update 6 (DkmApiVersion.VS15Update6).

public:
 static Microsoft::VisualStudio::Debugger::Clr::NativeCompilation::DkmClrNcInstructionSymbol ^ Create(Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Microsoft::VisualStudio::Debugger::Clr::DkmClrMethodId MethodId, System::UInt32 ILOffset, Guid LogicalMvid, System::UInt32 NativeOffset, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ GenericParameters, int ReferenceToken);
public static Microsoft.VisualStudio.Debugger.Clr.NativeCompilation.DkmClrNcInstructionSymbol Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, Microsoft.VisualStudio.Debugger.Clr.DkmClrMethodId MethodId, uint ILOffset, Guid LogicalMvid, uint NativeOffset, System.Collections.ObjectModel.ReadOnlyCollection<byte> GenericParameters, int ReferenceToken);
public static Microsoft.VisualStudio.Debugger.Clr.NativeCompilation.DkmClrNcInstructionSymbol Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, Microsoft.VisualStudio.Debugger.Clr.DkmClrMethodId MethodId, uint ILOffset, Guid LogicalMvid, uint NativeOffset, System.Collections.ObjectModel.ReadOnlyCollection<byte>? GenericParameters, int ReferenceToken);
static member Create : Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Microsoft.VisualStudio.Debugger.Clr.DkmClrMethodId * uint32 * Guid * uint32 * System.Collections.ObjectModel.ReadOnlyCollection<byte> * int -> Microsoft.VisualStudio.Debugger.Clr.NativeCompilation.DkmClrNcInstructionSymbol
Public Shared Function Create (Module As DkmModule, MethodId As DkmClrMethodId, ILOffset As UInteger, LogicalMvid As Guid, NativeOffset As UInteger, GenericParameters As ReadOnlyCollection(Of Byte), ReferenceToken As Integer) As DkmClrNcInstructionSymbol

Parameters

Module
DkmModule

[In] The DkmModule class represents a code bundle (ex: dll or exe) which is or once was loaded into one or more processes. The DkmModule class is the central object to the symbol APIs, and is 1:1 with the symbol handler's notation of what is loaded. If a code bundle loads into three different processes (or the same process but with three different base addresses or three different app domains) but the symbol handler thinks of all of these as being identical, there will be only one module object.

MethodId
DkmClrMethodId

[In] The version/token pair for this method.

ILOffset
UInt32

[In] ILOffset is the index of the IL instruction that this symbol represents. This value may be set to UInt32.MaxValue for an instruction that is within the given method, but not tied to a particular instruction. This is used for CLR native instructions that don't map to an IL instruction.

LogicalMvid
Guid

[In] The Mvid of the module where MethodId.Token is defined.

NativeOffset
UInt32

[In] This value is the RVA of the native instruction from the beginning of the native module that contains this instruction.

GenericParameters
ReadOnlyCollection<Byte>

[In,Optional] For generic methods, this provides the ECMA formatted TypeSpec signature for each generic parameter. For non-generic methods, this will be null. For non-merged modules this is relative to the mapping (or pseudo-IL assembly).

ReferenceToken
Int32

[In,Optional] In a multi-module assembly, MethodId.Token is a method token resolved to the appropriate virtual module. This token is can be looked up in the pseudo- assembly.

Returns

DkmClrNcInstructionSymbol

[Out] Result of this method call.

Applies to