DkmModuleInstance 类

参考

定义

命名空间:: Microsoft.VisualStudio.Debugger

程序集:: Microsoft.VisualStudio.Debugger.Engine.dll

包:: Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

Module Instance 类表示加载到特定位置的特定进程中的代码包 (例如 dll 或 exe) 。模块实例对象是 1：1，执行环境的概念为代码捆绑包。例如，在本机代码中，模块实例对象是具有基址的 1：1。

派生类：DkmClrModuleInstance、DkmClrNcModuleInstance、DkmCustomModuleInstance、DkmNativeModuleInstance、DkmClrNcContainerModuleInstance

public ref class DkmModuleInstance abstract : Microsoft::VisualStudio::Debugger::DkmDataContainer

[System.Runtime.InteropServices.Guid("74857b6f-618d-66e3-149e-6cebf4c4123e")]
public abstract class DkmModuleInstance : Microsoft.VisualStudio.Debugger.DkmDataContainer

[<System.Runtime.InteropServices.Guid("74857b6f-618d-66e3-149e-6cebf4c4123e")>]
type DkmModuleInstance = class
    inherit DkmDataContainer

Public MustInherit Class DkmModuleInstance
Inherits DkmDataContainer

继承: MarshalByRefObject

DkmDataContainer
DkmModuleInstance

继承: Object

DkmDataContainer
DkmModuleInstance

派生: Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance

Microsoft.VisualStudio.Debugger.Clr.NativeCompilation.DkmClrNcContainerModuleInstance

Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomModuleInstance

Microsoft.VisualStudio.Debugger.Native.DkmNativeModuleInstance

属性: GuidAttribute

属性

BaseAddress	[可选]模块加载位置的起始内存地址。如果模块未在连续内存块中加载，则此值将为零。
Connection	这表示监视器与 IDE 之间的连接。如果监视器与 IDE 在同一进程中运行，则它可以是本地连接，也可以是远程连接。在监视过程中，只有一个连接。
Flags	指示 DkmModuleInstance 特征的标志。
FullName	完全限定的模块名称。对于基于文件的模块，这是模块 (的完整路径，例如：c:\windows\system32\kernel32.dll。
IsDisabled	指示此模块实例是否已禁用。调试器在很大程度上会忽略禁用的模块。对于本机模块，禁用的模块的地址范围被视为未映射。对于 CLR 模块，这些模块中的任何帧都隐藏在调用堆栈中。
IsUnloaded	如果已为此对象引发“unloaded”事件，则返回 true (示例：DkmThread：：Unload) 或对象已关闭。请注意，检查此状态时必须小心，因为如果不进行同步，则返回的状态在读取指令后可能不再准确。 (继承自 DkmDataContainer)
LoadContext	加载此模块的上下文的字符串说明。例如：“Win32”或“CLR v2.0.50727：默认域”。
LoadOrder	加载到并包括此模块的模块实例数的整数计数。每个运行时实例跟踪其自己的加载顺序计数。
MemoryLayout	指示模块在内存中的布局方式的枚举。
MinidumpInfoPart	[可选]“MinidumpInfoPart”用于传达有关小型转储的 DkmProcess 中的模块的其他信息。
Module	[可选] (与此模块实例关联的 DkmModule) 模块的符号处理程序表示形式。此值最初为 null，并且当符号与此模块实例关联时分配。
Name	模块名称的简短表示形式。对于基于文件的模块，这是文件名和扩展名 (例如：kernel32.dll) 。
Process	DkmProcess 表示正在调试的目标进程。调试器调试进程，因此这是调试的基本单元。 DkmProcess 可以表示系统进程或虚拟进程，例如小型转用。
RuntimeInstance	DkmRuntimeInstance 类表示加载到 DkmProcess 中的执行环境，其中包含要调试的代码。
Size	[可选]模块内存区域中的字节数。如果模块未在连续的内存块中加载，则此值将为零。
SymbolFileId	[可选]包含查找此模块的符号所需的信息。在 Win32 上，此信息包含在IMAGE_DEBUG_DIRECTORY中。
TagValue	DkmModuleInstance 是抽象基类。此枚举指示此对象是哪个派生类的实例。
TimeDateStamp	生成已加载模块的日期/时间。此值是从已加载模块的IMAGE_NT_HEADERS获取的。度量单位是 FILETIME 值，它是一个 64 位值，表示自 1601 年 1 月 1 日 (UTC) 以来的 100 纳秒间隔数。
UniqueId	唯一标识 DkmModuleInstance 对象。
Version	[可选]文件版本信息。

方法

ClearTransitionModuleFlag()	运行时实例调用此方法将模块标记为边界模块。单步执行时，运行时应检查步骤是否达到边界模块，并启动单步仲裁（如果有）。请注意，某些运行时可能无法接受此请求。调度程序将保留已调用 FlagAsTransitionModule 的次数的计数。仅当对 ClearTransitionModuleFlag 的匹配调用数时，该模块将不再被视为转换模块。位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。
Decompile()	将模块的代码反编译为 C#，并创建嵌入此源的新可移植 PDB。共享此符号文件的所有模块都将开始使用这些更新的符号。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。此 API 是在 Visual Studio 16 Update 5 (DkmApiVersion.VS16Update5) 中引入的。
Decompile(DkmWorkList, DkmCompletionRoutine<DkmDecompileAsyncResult>)	将模块的代码反编译为 C#，并创建嵌入此源的新可移植 PDB。共享此符号文件的所有模块都将开始使用这些更新的符号。此方法会将新工作项追加到指定的工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。此 API 是在 Visual Studio 16 Update 5 (DkmApiVersion.VS16Update5) 中引入的。
Decompile(DkmWorkList, DkmCompletionRoutine<DkmDecompileAsyncResult173>)	将模块的代码反编译为 C#，并创建嵌入此源的新可移植 PDB。共享此符号文件的所有模块都将开始使用这些更新的符号。实现应在失败时返回S_OK，并通过“HR”和“ErrorMessage”参数返回实际的 HRESULT 和任何其他错误信息。此方法会将新工作项追加到指定的工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。此 API 是在 Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3) 中引入的。
Decompile(String, Int32)	将模块的代码反编译为 C#，并创建嵌入此源的新可移植 PDB。共享此符号文件的所有模块都将开始使用这些更新的符号。实现应在失败时返回S_OK，并通过“HR”和“ErrorMessage”参数返回实际的 HRESULT 和任何其他错误信息。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。此 API 是在 Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3) 中引入的。
FlagAsTransitionModule()	运行时实例调用此方法将模块标记为边界模块。单步执行时，运行时应检查步骤是否达到边界模块，并启动单步仲裁（如果有）。请注意，某些运行时可能无法接受此请求。调度程序将保留已调用的次数的计数。仅当对 ClearTransitionModuleFlag 的匹配调用数时，该模块将不再被视为转换模块。位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。
GetDataItem<T>()	获取已添加到此容器实例的“T”实例。如果此容器不包含“T”，则此函数将返回 null。 (继承自 DkmDataContainer)
GetGPUDisassembly(UInt64, UInt32, Boolean, Boolean)	获取 debuggee 模块实例中地址范围的反汇编。
GetGPUDisassemblySize()	返回 debuggee 模块实例中的反汇编大小。
GetNextGPUInstructionAddress(UInt64)	返回相对于起始地址的下一个指令的地址。
GetSymbolLoadInformation()	返回一个字符串，描述搜索符号的各个位置以及检查该位置的结果。此信息用于填充模块窗口中的“符号加载信息”。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。
GetSymbolSearchResult()	检索与此模块实例关联的任何符号搜索结果。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。此 API 是在 Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3) 中引入的。
GetSymbolSearchResult(DkmWorkList, DkmCompletionRoutine<DkmGetSymbolSearchResultAsyncResult>)	检索与此模块实例关联的任何符号搜索结果。此方法会将新工作项追加到指定的工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。此 API 是在 Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3) 中引入的。
GetSymbolStatusMessage(Boolean)	获取当前符号状态的本地化字符串说明。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。
GetSymbolStatusMessage(DkmWorkList, Boolean, DkmCompletionRoutine<DkmGetSymbolStatusMessageAsyncResult>)	获取当前符号状态的本地化字符串说明。此方法会将新工作项追加到指定的工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。
IsSuppressed()	此方法允许组件确定是否取消了模块的模块加载事件。此 API 是在 Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3) 中引入的。
IsTransitionModule()	如果任何运行时实例已将此模块标记为转换模块，则返回 true。位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。
IsUserCode()	确定模块是否被视为用户代码。位置约束：可以从 IDE 组件调用此方法。从 Visual Studio 2013 Update 2 开始，还可以从托管代码的监视组件调用它。从 Visual Studio 2017 Update 8 开始，API 的 CallDirection 已从“Normal”设置为“双向”，现在可以从任何组件调用，AsyncCaller 已设置为“true”，CallerLocationConstraint 在“NoMarshalling”中设置为“None”。此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 中引入的。
IsUserCode(DkmWorkList, DkmCompletionRoutine<DkmModuleInstanceIsUserCodeAsyncResult>)	确定模块是否被视为用户代码。此方法会将新工作项追加到指定工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。位置约束：可以从 IDE 组件调用此方法。从 Visual Studio 2013 Update 2 开始，还可以从托管代码的监视组件调用它。从 Visual Studio 2017 Update 8 开始，API 的 CallDirection 已从“Normal”设置为“双向”，现在可以从任何组件调用，AsyncCaller 已设置为“true”，CallerLocationConstraint 在“NoMarshalling”中设置为“None”。此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 中引入的。
OnBinaryLoaded(String)	引发 BinaryLoaded 事件。实现事件接收器接口的组件将收到事件通知。通知所有组件后，控制将返回。此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 中引入的。
OnBinaryReloadOpportunity()	引发 BinaryReloadOpportunity 事件。实现事件接收器接口的组件将收到事件通知。通知所有组件后，控制将返回。位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。此 API 是在 Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2) 中引入的。
OnModuleModified()	当模块由于 EnC 或动态发出的代码而更改时，将调用此方法。位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引入的。
OnSymbolsLoaded(DkmModule, Boolean)	此方法由基本调试监视器调用，以响应对 IDkmModuleSymbolsLoaded.RaiseSymbolsLoadedEvent 的调用。必须从事件线程或请求线程（作为重载的一部分）调用此方法。基本调试监视器应同步切换到事件线程，暂停目标进程，并调用 OnSymbolsLoaded。位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。
OnSymbolsUpdated(DkmModule)	引发 ModuleSymbolsUpdated 事件。实现事件接收器接口的组件将收到事件通知。通知所有组件后，控制将返回。
ReadSymbols()	此方法由符号处理程序调用，以读取其符号驻留在调试对象的内存中的 DkmModuleInstances 的符号。
RemoveDataItem<T>()	从此容器中删除“T”的实例。通常不需要调用此方法，因为数据容器将在对象关闭时自动清空。 (继承自 DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)	将新项放在数据容器中。 (继承自 DkmDataContainer)
SetDisabled(Boolean)	汇报模块的禁用状态。只能从 ModuleInstanceLoad 事件调用此方法。禁用模块时，通常还会取消模块加载事件。
SetModule(DkmModule, Boolean)	此方法由符号提供程序调用，以将 DkmModule 与 DkmModuleInstance 相关联，并触发 ModuleSymbolsLoaded 事件。对于 DkmModuleInstance 对象，它只能调用一次。调用此 API 将建立 DkmModule-DkmModuleInstance<> 关联，并引发 ModuleSymbolsLoaded 事件。
TryLoadBinary()	尝试加载以前无法使用更新的符号路径加载的二进制文件。
TryLoadBinary(DkmWorkList, DkmCompletionRoutine<DkmTryLoadBinaryAsyncResult>)	尝试加载以前无法使用更新的符号路径加载的二进制文件。此方法会将新工作项追加到指定工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。
TryLoadSymbols()	调用以启动 DkmModuleInstances 的符号加载，该 DkmModuleInstances 在模块加载时找不到其符号。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。
TryLoadSymbols(DkmSymbolLoadFlags)	调用以启动 DkmModuleInstances 的符号加载，该 DkmModuleInstances 在模块加载时找不到其符号。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。此 API 是在 Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4) 中引入的。
TryLoadSymbols(DkmWorkList, DkmCompletionRoutine<DkmTryLoadSymbolsAsyncResult>)	调用以启动 DkmModuleInstances 的符号加载，该 DkmModuleInstances 在模块加载时找不到其符号。此方法会将新工作项追加到指定工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。
TryLoadSymbols(DkmWorkList, DkmSymbolLoadFlags, DkmCompletionRoutine<DkmTryLoadSymbolsAsyncResult>)	调用以启动 DkmModuleInstances 的符号加载，该 DkmModuleInstances 在模块加载时找不到其符号。此方法会将新工作项追加到指定工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。位置约束：必须从 IDE 组件 (组件级别 > 100,000) 调用 API。此 API 是在 Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4) 中引入的。
TryLoadSymbolsCallback()	调用以启动 DkmModuleInstances 的符号加载，该 DkmModuleInstances 在模块加载时找不到其符号。位置约束：可从客户端或服务器调用。此的服务器实现是一个缓存，用于防止不必要的网络调用。客户端直接转到“real”实现，这也可确保重新尝试提前返回。此 API 是在 Visual Studio 17 RTM (DkmApiVersion.VS17RTM) 中引入的。
TryLoadSymbolsCallback(DkmWorkList, DkmCompletionRoutine<DkmTryLoadSymbolsCallbackAsyncResult>)	调用以启动 DkmModuleInstances 的符号加载，该 DkmModuleInstances 在模块加载时找不到其符号。此方法会将新工作项追加到指定的工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。位置约束：可以从客户端或服务器调用。此的服务器实现是一个缓存，以防止不必要的网络调用。客户端直接转到“real”实现，这还可确保重新尝试提前返回。此 API 是在 Visual Studio 17 RTM (DkmApiVersion.VS17RTM) 中引入的。
TryLoadSymbolsCallback177(DkmSymbolLoadFlags)	调用以启动加载在模块加载时找不到其符号的 DkmModuleInstances 的本地现有符号。位置约束：可以从客户端或服务器调用。此的服务器实现是一个缓存，以防止不必要的网络调用。客户端直接转到“real”实现，这还可确保重新尝试提前返回。此 API 是在 Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) 中引入的。
TryLoadSymbolsCallback177(DkmWorkList, DkmSymbolLoadFlags, DkmCompletionRoutine<DkmTryLoadSymbolsCallback177AsyncResult>)	调用以启动加载在模块加载时找不到其符号的 DkmModuleInstances 的本地现有符号。此方法会将新工作项追加到指定的工作列表，并在追加工作项后返回。工作项的实际处理是异步的。将通过完成例程通知调用方请求已完成。位置约束：可以从客户端或服务器调用。此的服务器实现是一个缓存，以防止不必要的网络调用。客户端直接转到“real”实现，这还可确保重新尝试提前返回。此 API 是在 Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) 中引入的。
Unload()	将 Unload 对象标记为已卸载，并通知实现事件接收器接口的组件。一旦通知所有组件，控件将返回。此方法只能由创建对象的组件调用。

适用于

通过

DkmModuleInstance 类

定义

属性

方法

适用于

其他资源