DkmCustomModuleInstance.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建新的 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"。
返回
弄此方法调用的结果。