DkmCustomInstructionSymbol.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建新的 DkmCustomInstructionSymbol 对象实例。
public:
static Microsoft::VisualStudio::Debugger::CustomRuntimes::DkmCustomInstructionSymbol ^ Create(Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Guid RuntimeType, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ EntityId, System::UInt64 Offset, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ AdditionalData);
public static Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomInstructionSymbol Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, Guid RuntimeType, System.Collections.ObjectModel.ReadOnlyCollection<byte> EntityId, ulong Offset, System.Collections.ObjectModel.ReadOnlyCollection<byte> AdditionalData);
static member Create : Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Guid * System.Collections.ObjectModel.ReadOnlyCollection<byte> * uint64 * System.Collections.ObjectModel.ReadOnlyCollection<byte> -> Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomInstructionSymbol
Public Shared Function Create (Module As DkmModule, RuntimeType As Guid, EntityId As ReadOnlyCollection(Of Byte), Offset As ULong, AdditionalData As ReadOnlyCollection(Of Byte)) As DkmCustomInstructionSymbol
参数
- Module
- DkmModule
中DkmModule 类表示 (ex: dll 或 exe) 的代码绑定,或将其加载到一个或多个进程中。 DkmModule 类是指向符号 Api 的中心对象,为1:1,并带有符号处理程序的表示形式。 如果代码绑定加载到三个不同的进程 (或相同的进程,但具有三个不同的基址或三个不同的应用程序域) 但符号处理程序认为所有这些都是相同的,则将只有一个 module 对象。
- RuntimeType
- Guid
中运行时 Id 标识特定代码段的执行环境。 调度程序使用运行时 Id 来决定要调度到的监视器。 请注意,运行时 ID Guid 的排序有点重要,因为这会指示在仲裁期间哪个运行时获取第一个快照。 因此,如果一个要声明在 CLR 上构建的新的运行时实例,则运行时 id 应小于 DkmRuntimeId。
- EntityId
- ReadOnlyCollection<Byte>
[In,可选]这是特定于运行时的数据结构,自定义运行时可使用该结构来存储此指令的位置。 除了 "偏移量",此字段还用于比较同一个模块中的两个指令。
- Offset
- UInt64
中"偏移量" 字段与 "EntityId" 一起用于唯一标识指令。 这可以保存指针值 (如指向指令的指针) 或从函数/模块的开头开始的偏移量。
- AdditionalData
- ReadOnlyCollection<Byte>
[In,可选]与某个地址相关联的其他特定于运行时的数据。 比较地址时将不使用此数据。
返回
弄此方法调用的结果。