DkmNativeModuleInstance.Create 方法

定义

创建新的 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"。

返回

DkmNativeModuleInstance

弄此方法调用的结果。

适用于