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)

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

[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);
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

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

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

[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

[Out] Result of this method call.

Applies to