DkmRuntimeHardwareDataBreakpoint.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建新的 DkmRuntimeHardwareDataBreakpoint 对象。 创建后,断点处于禁用状态,必须显式启用。 调用方负责在完成后关闭创建的对象。
public:
static Microsoft::VisualStudio::Debugger::Breakpoints::DkmRuntimeHardwareDataBreakpoint ^ Create(Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ RuntimeInstance, Guid SourceId, Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, System::UInt64 Address, Microsoft::VisualStudio::Debugger::Breakpoints::DkmDataAccessStopMask Access, int Size, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Breakpoints.DkmRuntimeHardwareDataBreakpoint Create (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance, Guid SourceId, Microsoft.VisualStudio.Debugger.DkmThread Thread, ulong Address, Microsoft.VisualStudio.Debugger.Breakpoints.DkmDataAccessStopMask Access, int Size, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Guid * Microsoft.VisualStudio.Debugger.DkmThread * uint64 * Microsoft.VisualStudio.Debugger.Breakpoints.DkmDataAccessStopMask * int * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Breakpoints.DkmRuntimeHardwareDataBreakpoint
Public Shared Function Create (RuntimeInstance As DkmRuntimeInstance, SourceId As Guid, Thread As DkmThread, Address As ULong, Access As DkmDataAccessStopMask, Size As Integer, DataItem As DkmDataItem) As DkmRuntimeHardwareDataBreakpoint
参数
- RuntimeInstance
- DkmRuntimeInstance
中DkmRuntimeInstance 类表示加载到 DkmProcess 中的执行环境,其中包含要调试的代码。
- SourceId
- Guid
中标识对象的源。 当多个组件可能创建类的实例时,SourceIds 用于在方案中启用筛选。 例如,源 id 可用于确定断点是否来自 AD7 AL (ex: user 断点或其他) SDM 级别可见的断点,而不是可能由另一个组件创建的断点 (例如,用于单步执行) 的内部断点。
- Thread
- DkmThread
[In,可选]应在其上激发此断点的线程。 如果为 null,则将在所有线程上触发断点。
- Address
- UInt64
中要在其上停止的地址。 必须适当调整此地址以匹配大小参数 (示例:如果 Size 为4,则 Address 必须是 4) 的倍数。
- Access
- DkmDataAccessStopMask
中屏蔽应激发数据断点的原因。 例如,如果设置了 "Write",则在写入内存位置时将激发断点。
- Size
- Int32
中指定监视访问的位置大小(以字节为单位)。 在基于 x86 的处理器上,此参数可以是1、2或4。 但是,如果 DkmDataAccessStopMask.Exe很漂亮,则大小必须为1。 在基于 x64 的处理器上,此参数可以是1、2、4或8。 但是,如果 DkmDataAccessStopMask.Exe很漂亮,则大小必须为1。 在基于 Itanium 的处理器上,此参数可以是2的任何幂,从1到0x80000000。
- DataItem
- DkmDataItem
[In,可选]要添加到新的 DkmRuntimeHardwareDataBreakpoint 实例的数据对象。 如果调用方不需要添加数据项,则传递 "null"。
返回
弄此方法调用的结果。