DkmClrModuleInstance.Create Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Debugger.Clr

Assembly:: Microsoft.VisualStudio.Debugger.Engine.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

Create a new DkmClrModuleInstance object instance.

This method will send a ModuleInstanceLoad event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, UInt32, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

Create a new DkmClrModuleInstance object instance.

This method will send a ModuleInstanceLoad event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

Create a new DkmClrModuleInstance object instance.

This method will send a ModuleInstanceLoad event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

public:
 static Microsoft::VisualStudio::Debugger::Clr::DkmClrModuleInstance ^ Create(System::String ^ Name, System::String ^ FullName, System::UInt64 TimeDateStamp, Microsoft::VisualStudio::Debugger::DkmModuleVersion ^ Version, Microsoft::VisualStudio::Debugger::Symbols::DkmSymbolFileId ^ SymbolFileId, Microsoft::VisualStudio::Debugger::DkmModuleFlags Flags, Microsoft::VisualStudio::Debugger::DkmModuleMemoryLayout MemoryLayout, System::UInt64 BaseAddress, System::UInt32 LoadOrder, System::UInt32 Size, System::String ^ LoadContext, Microsoft::VisualStudio::Debugger::Clr::DkmClrRuntimeInstance ^ RuntimeInstance, Guid Mvid, Microsoft::VisualStudio::Debugger::Clr::DkmClrModuleFlags ClrFlags, Microsoft::VisualStudio::Debugger::Clr::DkmClrAppDomain ^ AppDomain, bool IsDisabled, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Microsoft::VisualStudio::Debugger::DkmModuleInstance::MinidumpInfo ^ MinidumpInfo, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance Create (string Name, string FullName, ulong TimeDateStamp, Microsoft.VisualStudio.Debugger.DkmModuleVersion Version, Microsoft.VisualStudio.Debugger.Symbols.DkmSymbolFileId SymbolFileId, Microsoft.VisualStudio.Debugger.DkmModuleFlags Flags, Microsoft.VisualStudio.Debugger.DkmModuleMemoryLayout MemoryLayout, ulong BaseAddress, uint LoadOrder, uint Size, string LoadContext, Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance RuntimeInstance, Guid Mvid, Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleFlags ClrFlags, Microsoft.VisualStudio.Debugger.Clr.DkmClrAppDomain AppDomain, bool IsDisabled, Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo MinidumpInfo, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);

static member Create : string * string * uint64 * Microsoft.VisualStudio.Debugger.DkmModuleVersion * Microsoft.VisualStudio.Debugger.Symbols.DkmSymbolFileId * Microsoft.VisualStudio.Debugger.DkmModuleFlags * Microsoft.VisualStudio.Debugger.DkmModuleMemoryLayout * uint64 * uint32 * uint32 * string * Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance * Guid * Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleFlags * Microsoft.VisualStudio.Debugger.Clr.DkmClrAppDomain * bool * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance

Public Shared Function Create (Name As String, FullName As String, TimeDateStamp As ULong, Version As DkmModuleVersion, SymbolFileId As DkmSymbolFileId, Flags As DkmModuleFlags, MemoryLayout As DkmModuleMemoryLayout, BaseAddress As ULong, LoadOrder As UInteger, Size As UInteger, LoadContext As String, RuntimeInstance As DkmClrRuntimeInstance, Mvid As Guid, ClrFlags As DkmClrModuleFlags, AppDomain As DkmClrAppDomain, IsDisabled As Boolean, Module As DkmModule, MinidumpInfo As DkmModuleInstance.MinidumpInfo, DataItem As DkmDataItem) As DkmClrModuleInstance

Parameters

Name: String

[In] Short representation of the module name. For file-based modules, this is the file name and extension (ex: kernel32.dll).

FullName: String

[In] Fully qualified module name. For file-based modules, this is the full path to the module (ex: c:\windows\system32\kernel32.dll.

TimeDateStamp: UInt64

[In] Date/Time of when the loaded module was built. This value is obtained from the IMAGE_NT_HEADERS of the loaded module. The unit of measurement is a FILETIME value, which is a 64-bit value representing the number of 100-nanosecond intervals since January 1, 1601 (UTC).

Version: DkmModuleVersion

[In,Optional] File version information.

SymbolFileId: DkmSymbolFileId

[In,Optional] Contains information needed to locate symbols for this module. On Win32, this information is contained within the IMAGE_DEBUG_DIRECTORY.

Flags: DkmModuleFlags

[In] Flags which indicate traits of a DkmModuleInstance.

MemoryLayout: DkmModuleMemoryLayout

[In] Enumeration that indicates how a module is laid out in memory.

BaseAddress: UInt64

[In,Optional] The starting memory address of where the module loaded. This value will be zero if the module did not load in a contiguous block of memory.

LoadOrder: UInt32

[In] The integer count of the number of module instances that have loaded up to and including this module. Each runtime instance keeps track of its own load order count.

Size: UInt32

[In,Optional] The number of bytes in the module's memory region. This value will be zero if the module did not load in a contiguous block of memory.

LoadContext: String

[In] String description of the context under which this module has been loaded. ex: 'Win32' or 'CLR v2.0.50727: Default Domain'.

RuntimeInstance: DkmClrRuntimeInstance

[In] Represents a CLR instance running in a target process.

Mvid: Guid

[In] Module Version Identifier from the loaded module. This is a unique value which is embedded in an exe/dll by linkers/compilers when the dll/exe is built. A new value is generated each time that the dll/exe is compiled.

ClrFlags: DkmClrModuleFlags

[In] Flags which indicates traits of a DkmModuleInstance which has been loaded by the CLR.

AppDomain: DkmClrAppDomain

[In] DkmClrAppDomain represents a CLR app domain inside a process which is being debugged.

IsDisabled: Boolean

[In] Indicates if this module instance has been disabled. Disabled modules are largely ignored by the debugger. For native modules, the address range of the disabled module is treated as if it is unmapped. For CLR modules, any frames from these modules is hidden from the call stack.

Module: DkmModule

[In,Optional] The symbol handler's representation of a module (DkmModule) which is associated with this module instance. This value is initially null, and is assigned if and when symbols are associated with this module instance.

MinidumpInfo: DkmModuleInstance.MinidumpInfo

[In,Optional] 'MinidumpInfo' is used to convey additional information about modules in a DkmProcess for a minidump.

DataItem: DkmDataItem

[In,Optional] Data object to add to the new DkmClrModuleInstance instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

DkmClrModuleInstance

[Out] Result of this method call.

Applies to

Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, UInt32, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

Create a new DkmClrModuleInstance object instance.

This method will send a ModuleInstanceLoad event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

public:
 static Microsoft::VisualStudio::Debugger::Clr::DkmClrModuleInstance ^ Create(System::String ^ Name, System::String ^ FullName, System::UInt64 TimeDateStamp, Microsoft::VisualStudio::Debugger::DkmModuleVersion ^ Version, Microsoft::VisualStudio::Debugger::Symbols::DkmSymbolFileId ^ SymbolFileId, Microsoft::VisualStudio::Debugger::DkmModuleFlags Flags, Microsoft::VisualStudio::Debugger::DkmModuleMemoryLayout MemoryLayout, System::UInt64 BaseAddress, System::UInt32 LoadOrder, System::UInt32 Size, System::String ^ LoadContext, Microsoft::VisualStudio::Debugger::Clr::DkmClrRuntimeInstance ^ RuntimeInstance, Guid Mvid, Microsoft::VisualStudio::Debugger::Clr::DkmClrModuleFlags ClrFlags, Microsoft::VisualStudio::Debugger::Clr::DkmClrAppDomain ^ AppDomain, System::UInt32 ILImageSize, bool IsDisabled, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Microsoft::VisualStudio::Debugger::DkmModuleInstance::MinidumpInfo ^ MinidumpInfo, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance Create (string Name, string FullName, ulong TimeDateStamp, Microsoft.VisualStudio.Debugger.DkmModuleVersion Version, Microsoft.VisualStudio.Debugger.Symbols.DkmSymbolFileId SymbolFileId, Microsoft.VisualStudio.Debugger.DkmModuleFlags Flags, Microsoft.VisualStudio.Debugger.DkmModuleMemoryLayout MemoryLayout, ulong BaseAddress, uint LoadOrder, uint Size, string LoadContext, Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance RuntimeInstance, Guid Mvid, Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleFlags ClrFlags, Microsoft.VisualStudio.Debugger.Clr.DkmClrAppDomain AppDomain, uint ILImageSize, bool IsDisabled, Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo MinidumpInfo, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);

static member Create : string * string * uint64 * Microsoft.VisualStudio.Debugger.DkmModuleVersion * Microsoft.VisualStudio.Debugger.Symbols.DkmSymbolFileId * Microsoft.VisualStudio.Debugger.DkmModuleFlags * Microsoft.VisualStudio.Debugger.DkmModuleMemoryLayout * uint64 * uint32 * uint32 * string * Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance * Guid * Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleFlags * Microsoft.VisualStudio.Debugger.Clr.DkmClrAppDomain * uint32 * bool * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance

Public Shared Function Create (Name As String, FullName As String, TimeDateStamp As ULong, Version As DkmModuleVersion, SymbolFileId As DkmSymbolFileId, Flags As DkmModuleFlags, MemoryLayout As DkmModuleMemoryLayout, BaseAddress As ULong, LoadOrder As UInteger, Size As UInteger, LoadContext As String, RuntimeInstance As DkmClrRuntimeInstance, Mvid As Guid, ClrFlags As DkmClrModuleFlags, AppDomain As DkmClrAppDomain, ILImageSize As UInteger, IsDisabled As Boolean, Module As DkmModule, MinidumpInfo As DkmModuleInstance.MinidumpInfo, DataItem As DkmDataItem) As DkmClrModuleInstance

Parameters

Name: String

[In] Short representation of the module name. For file-based modules, this is the file name and extension (ex: kernel32.dll).

FullName: String

[In] Fully qualified module name. For file-based modules, this is the full path to the module (ex: c:\windows\system32\kernel32.dll.

TimeDateStamp: UInt64

Version: DkmModuleVersion

[In,Optional] File version information.

SymbolFileId: DkmSymbolFileId

[In,Optional] Contains information needed to locate symbols for this module. On Win32, this information is contained within the IMAGE_DEBUG_DIRECTORY.

Flags: DkmModuleFlags

[In] Flags which indicate traits of a DkmModuleInstance.

MemoryLayout: DkmModuleMemoryLayout

[In] Enumeration that indicates how a module is laid out in memory.

BaseAddress: UInt64

[In,Optional] The starting memory address of where the module loaded. This value will be zero if the module did not load in a contiguous block of memory.

LoadOrder: UInt32

[In] The integer count of the number of module instances that have loaded up to and including this module. Each runtime instance keeps track of its own load order count.

Size: UInt32

[In,Optional] The number of bytes in the module's memory region. This value will be zero if the module did not load in a contiguous block of memory.

LoadContext: String

[In] String description of the context under which this module has been loaded. ex: 'Win32' or 'CLR v2.0.50727: Default Domain'.

RuntimeInstance: DkmClrRuntimeInstance

[In] Represents a CLR instance running in a target process.

Mvid: Guid

ClrFlags: DkmClrModuleFlags

[In] Flags which indicates traits of a DkmModuleInstance which has been loaded by the CLR.

AppDomain: DkmClrAppDomain

[In] DkmClrAppDomain represents a CLR app domain inside a process which is being debugged.

ILImageSize: UInt32

[In] Specifies the size of the IL image of this module, as it pertains to symbol server lookup. For Desktop .NET Framework, this will specify the IL image size which will differ from the raw image size in the case of ngen. This is because the IL only image is what is indexed on Symbol Servers. For .NET Core ngen and ready to run, this will specify the raw image size as the ngen/ready to run image is what is indexed and we do not want to do lookup based on IL only image size.

IsDisabled: Boolean

Module: DkmModule

MinidumpInfo: DkmModuleInstance.MinidumpInfo

[In,Optional] 'MinidumpInfo' is used to convey additional information about modules in a DkmProcess for a minidump.

DataItem: DkmDataItem

[In,Optional] Data object to add to the new DkmClrModuleInstance instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

DkmClrModuleInstance

[Out] Result of this method call.

Applies to

DkmClrModuleInstance.Create Method

Definition

Overloads

Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

Parameters

Returns

Applies to

Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, UInt32, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

Parameters

Returns

Applies to

Další materiály