DkmPendingDataBreakpoint.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建新的挂起断点对象。 创建后,返回的对象仍将被禁用,并且不会被断点管理器跟踪。 若要完成初始化,调用方应在断点上设置附加属性,并将其设置为 "启用" 或 "注册"。 调用方负责在完成后关闭创建的对象。
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"。
返回
弄此方法调用的结果。