DkmNativeModuleInstance.Create Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Native

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Create a new DkmNativeModuleInstance 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::Native::DkmNativeModuleInstance ^ 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::UInt32 LoadOrder, System::String ^ LoadContext, Microsoft::VisualStudio::Debugger::Native::DkmNativeRuntimeInstance ^ RuntimeInstance, System::UInt64 BaseAddress, System::UInt32 Size, Microsoft::VisualStudio::Debugger::Clr::DkmClrHeaderStatus ClrHeaderStatus, bool IsDisabled, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Microsoft::VisualStudio::Debugger::DkmModuleInstance::MinidumpInfo ^ MinidumpInfo, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.Native.DkmNativeModuleInstance 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, uint LoadOrder, string LoadContext, Microsoft.VisualStudio.Debugger.Native.DkmNativeRuntimeInstance RuntimeInstance, ulong BaseAddress, uint Size, Microsoft.VisualStudio.Debugger.Clr.DkmClrHeaderStatus ClrHeaderStatus, 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 * uint32 * string * Microsoft.VisualStudio.Debugger.Native.DkmNativeRuntimeInstance * uint64 * uint32 * Microsoft.VisualStudio.Debugger.Clr.DkmClrHeaderStatus * bool * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Native.DkmNativeModuleInstance

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, LoadOrder As UInteger, LoadContext As String, RuntimeInstance As DkmNativeRuntimeInstance, BaseAddress As ULong, Size As UInteger, ClrHeaderStatus As DkmClrHeaderStatus, IsDisabled As Boolean, Module As DkmModule, MinidumpInfo As DkmModuleInstance.MinidumpInfo, DataItem As DkmDataItem) As DkmNativeModuleInstance

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.

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.

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

DkmNativeRuntimeInstance

[In] Represents the native code executing in a target process.

BaseAddress

UInt64

[In] The starting memory address of where the module is loaded. This value should always be valid.

Size

UInt32

[In] The number of bytes in the module's memory region.

ClrHeaderStatus

DkmClrHeaderStatus

[In] Contains information from the 'Flags' field of the IMAGE_COR20_HEADER of the loaded module. This indicates which type of binary was loaded.

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

Returns

DkmNativeModuleInstance

[Out] Result of this method call.