DkmPendingDataBreakpoint.Create 方法

定义

创建新的挂起断点对象。 创建后,返回的对象仍将被禁用,并且不会被断点管理器跟踪。 若要完成初始化,调用方应在断点上设置附加属性,并将其设置为 "启用" 或 "注册"。 调用方负责在完成后关闭创建的对象。

public:
 static Microsoft::VisualStudio::Debugger::Breakpoints::DkmPendingDataBreakpoint ^ Create(Microsoft::VisualStudio::Debugger::DkmProcess ^ Process, Guid SourceId, Microsoft::VisualStudio::Debugger::Evaluation::DkmCompilerId CompilerId, Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, bool IsBarrier, System::String ^ DataElementLocation, int Size, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Breakpoints.DkmPendingDataBreakpoint Create (Microsoft.VisualStudio.Debugger.DkmProcess Process, Guid SourceId, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DkmThread Thread, bool IsBarrier, string DataElementLocation, int Size, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmProcess * Guid * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * Microsoft.VisualStudio.Debugger.DkmThread * bool * string * int * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Breakpoints.DkmPendingDataBreakpoint
Public Shared Function Create (Process As DkmProcess, SourceId As Guid, CompilerId As DkmCompilerId, Thread As DkmThread, IsBarrier As Boolean, DataElementLocation As String, Size As Integer, DataItem As DkmDataItem) As DkmPendingDataBreakpoint

参数

Process
DkmProcess

中DkmProcess 表示正在调试的目标进程。 调试器调试进程,因此这是调试的基本单元。 DkmProcess 可以表示系统进程或虚拟进程,如小型转储。

SourceId
Guid

中标识对象的源。 当多个组件可能创建类的实例时,SourceIds 用于在方案中启用筛选。 例如,源 id 可用于确定断点是否来自 AD7 AL (ex: user 断点或其他) SDM 级别可见的断点,而不是可能由另一个组件创建的断点 (例如,用于单步执行) 的内部断点。

CompilerId
DkmCompilerId

中标识源语言 (ex: c # ) 和编译器供应商 (ex:应将断点绑定到的 Microsoft) 。 "LanguageId" 可以保留为 Guid.empty,以指示该断点应绑定到所有语言。 "VendorId" 几乎始终保留为 Guid.empty,这表示仅知道语言 (编译器) 。

Thread
DkmThread

[In,可选]应在其上激发此断点的线程。 如果为 null,则将在所有线程上触发断点。

IsBarrier
Boolean

中指示此断点是否为应在硬件上设置的关卡,适用于 GPU 调试。

DataElementLocation
String

中指示要监视的数据值的位置。

Size
Int32

中指定监视访问的位置大小(以字节为单位)。 有效的大小可能取决于目标处理器 (x86、x64 等) 和正在调试的代码类型。 例如,本机代码利用 CPU 的断点寄存器,而基于 x86 的处理器支持的大小为1、2和4。

DataItem
DkmDataItem

[In,可选]要添加到新的 DkmPendingDataBreakpoint 实例的数据对象。 如果调用方不需要添加数据项,则传递 "null"。

返回

DkmPendingDataBreakpoint

弄此方法调用的结果。

适用于