DkmRuntimeHardwareDataBreakpoint.Create 方法

定义

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

返回

DkmRuntimeHardwareDataBreakpoint

弄此方法调用的结果。

适用于