DkmNativeModuleInstance.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建新的 DkmNativeModuleInstance 对象实例。
此方法将发送 ModuleInstanceLoad 事件。
位置约束:必须从监视器组件 (组件级别 100000) 中调用 API < 。
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
参数
- Name
- String
中模块名称的短表示形式。 对于基于文件的模块,这是文件名和扩展名 (例如: kernel32.dll) 。
- FullName
- String
中完全限定的模块名称。 对于基于文件的模块,这是模块的完整路径 (ex: c:\windows\system32\kernel32.dll。
- TimeDateStamp
- UInt64
中生成加载的模块的日期/时间。 此值从加载的模块的 IMAGE_NT_HEADERS 中获取。 度量单位是 FILETIME 值,这是一个64位值,表示自年1月1日起 1601 (UTC) 以来的100毫微秒间隔数。
- Version
- DkmModuleVersion
[In,可选]文件版本信息。
- SymbolFileId
- DkmSymbolFileId
[In,可选]包含查找此模块的符号所需的信息。 在 Win32 上,此信息包含在 IMAGE_DEBUG_DIRECTORY 中。
- Flags
- DkmModuleFlags
中指示 DkmModuleInstance 特征的标志。
- MemoryLayout
- DkmModuleMemoryLayout
中枚举,指示模块在内存中的布局方式。
- LoadOrder
- UInt32
中已加载到并包含此模块的模块实例数的整数计数。 每个运行时实例跟踪其自己的加载顺序计数。
- LoadContext
- String
中已加载此模块的上下文的字符串说明。 例如: "Win32" 或 "CLR 2.0.50727: Default Domain"。
- RuntimeInstance
- DkmNativeRuntimeInstance
中表示在目标进程中执行的本机代码。
- BaseAddress
- UInt64
中加载模块的起始内存地址。 此值应始终有效。
- Size
- UInt32
中模块的内存区域中的字节数。
- ClrHeaderStatus
- DkmClrHeaderStatus
中包含已加载模块的 IMAGE_COR20_HEADER 的 "标志" 字段的信息。 这指示加载了哪种类型的二进制文件。
- IsDisabled
- Boolean
中指示是否已禁用此模块实例。 调试器将在很大程度上忽略禁用的模块。 对于本机模块,禁用模块的地址范围被视为未映射。 对于 CLR 模块,这些模块中的所有帧都隐藏在调用堆栈中。
- Module
- DkmModule
[In,可选]符号处理程序与此模块实例关联的模块 (DkmModule) 的表示形式。 此值最初为 null,当符号与此模块实例相关联时,将赋值。
- MinidumpInfo
- DkmModuleInstance.MinidumpInfo
[In,可选]"MinidumpInfo" 用于为小型转储的 DkmProcess 中的模块传递附加信息。
- DataItem
- DkmDataItem
[In,可选]要添加到新的 DkmNativeModuleInstance 实例的数据对象。 如果调用方不需要添加数据项,则传递 "null"。
返回
弄此方法调用的结果。