DkmCustomModuleInstance.Create Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.CustomRuntimes

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Create a new DkmCustomModuleInstance 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::CustomRuntimes::DkmCustomModuleInstance ^ Create(System::String ^ Name, System::String ^ FullName, System::UInt64 TimeDateStamp, Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ RuntimeInstance, 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, bool IsDisabled, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Microsoft::VisualStudio::Debugger::DkmModuleInstance::MinidumpInfo ^ MinidumpInfo, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomModuleInstance Create (string Name, string FullName, ulong TimeDateStamp, Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance, 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, 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.DkmRuntimeInstance * Microsoft.VisualStudio.Debugger.DkmModuleVersion * Microsoft.VisualStudio.Debugger.Symbols.DkmSymbolFileId * Microsoft.VisualStudio.Debugger.DkmModuleFlags * Microsoft.VisualStudio.Debugger.DkmModuleMemoryLayout * uint64 * uint32 * uint32 * string * bool * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomModuleInstance

Public Shared Function Create (Name As String, FullName As String, TimeDateStamp As ULong, RuntimeInstance As DkmRuntimeInstance, Version As DkmModuleVersion, SymbolFileId As DkmSymbolFileId, Flags As DkmModuleFlags, MemoryLayout As DkmModuleMemoryLayout, BaseAddress As ULong, LoadOrder As UInteger, Size As UInteger, LoadContext As String, IsDisabled As Boolean, Module As DkmModule, MinidumpInfo As DkmModuleInstance.MinidumpInfo, DataItem As DkmDataItem) As DkmCustomModuleInstance

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

RuntimeInstance

DkmRuntimeInstance

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

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

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 DkmCustomModuleInstance instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

DkmCustomModuleInstance

[Out] Result of this method call.