DkmCustomModuleInstance.Create 方法

定义

创建新的 DkmCustomModuleInstance 对象实例。

此方法将发送 ModuleInstanceLoad 事件。

位置约束:必须从监视器组件 (组件级别 100000) 中调用 API < 。

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

参数

Name
String

中模块名称的短表示形式。 对于基于文件的模块,这是文件名和扩展名 (例如: kernel32.dll) 。

FullName
String

中完全限定的模块名称。 对于基于文件的模块,这是模块的完整路径 (ex: c:\windows\system32\kernel32.dll。

TimeDateStamp
UInt64

中生成加载的模块的日期/时间。 此值从加载的模块的 IMAGE_NT_HEADERS 中获取。 度量单位是 FILETIME 值,这是一个64位值,表示自年1月1日起 1601 (UTC) 以来的100毫微秒间隔数。

RuntimeInstance
DkmRuntimeInstance

中DkmRuntimeInstance 类表示加载到 DkmProcess 中的执行环境,其中包含要调试的代码。

Version
DkmModuleVersion

[In,可选]文件版本信息。

SymbolFileId
DkmSymbolFileId

[In,可选]包含查找此模块的符号所需的信息。 在 Win32 上,此信息包含在 IMAGE_DEBUG_DIRECTORY 中。

Flags
DkmModuleFlags

中指示 DkmModuleInstance 特征的标志。

MemoryLayout
DkmModuleMemoryLayout

中枚举,指示模块在内存中的布局方式。

BaseAddress
UInt64

[In,可选]模块加载到的的起始内存地址。 如果该模块未在连续内存块中加载,则此值将为零。

LoadOrder
UInt32

中已加载到并包含此模块的模块实例数的整数计数。 每个运行时实例跟踪其自己的加载顺序计数。

Size
UInt32

[In,可选]模块的内存区域中的字节数。 如果该模块未在连续内存块中加载,则此值将为零。

LoadContext
String

中已加载此模块的上下文的字符串说明。 例如: "Win32" 或 "CLR 2.0.50727: Default Domain"。

IsDisabled
Boolean

中指示是否已禁用此模块实例。 调试器将在很大程度上忽略禁用的模块。 对于本机模块,禁用模块的地址范围被视为未映射。 对于 CLR 模块,这些模块中的所有帧都隐藏在调用堆栈中。

Module
DkmModule

[In,可选]符号处理程序与此模块实例关联的模块 (DkmModule) 的表示形式。 此值最初为 null,当符号与此模块实例相关联时,将赋值。

MinidumpInfo
DkmModuleInstance.MinidumpInfo

[In,可选]"MinidumpInfo" 用于为小型转储的 DkmProcess 中的模块传递附加信息。

DataItem
DkmDataItem

[In,可选]要添加到新的 DkmCustomModuleInstance 实例的数据对象。 如果调用方不需要添加数据项,则传递 "null"。

返回

DkmCustomModuleInstance

弄此方法调用的结果。

适用于