DkmPendingAddressBreakpoint.Create Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates a new pending breakpoint object. After creation, the returned object will still be disabled and will not be tracked by the breakpoint manager. To complete initialization, the caller should set additional properties on the breakpoint and 'Enable' or 'Enroll' it. The caller is responsible for closing the created object after they are done.
public:
static Microsoft::VisualStudio::Debugger::Breakpoints::DkmPendingAddressBreakpoint ^ Create(Guid SourceId, Microsoft::VisualStudio::Debugger::Evaluation::DkmCompilerId CompilerId, Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, bool IsBarrier, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ InstructionAddress, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Breakpoints.DkmPendingAddressBreakpoint Create (Guid SourceId, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DkmThread Thread, bool IsBarrier, Microsoft.VisualStudio.Debugger.DkmInstructionAddress InstructionAddress, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.Breakpoints.DkmPendingAddressBreakpoint Create (Guid SourceId, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DkmThread? Thread, bool IsBarrier, Microsoft.VisualStudio.Debugger.DkmInstructionAddress InstructionAddress, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Guid * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * Microsoft.VisualStudio.Debugger.DkmThread * bool * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Breakpoints.DkmPendingAddressBreakpoint
Public Shared Function Create (SourceId As Guid, CompilerId As DkmCompilerId, Thread As DkmThread, IsBarrier As Boolean, InstructionAddress As DkmInstructionAddress, DataItem As DkmDataItem) As DkmPendingAddressBreakpoint
Parameters
- SourceId
- Guid
[In] Identifies the source of an object. SourceIds are used to enable filtering in scenarios when multiple components may be creating instances of a class. For example, source ids can be used to determine if a breakpoint comes from the AD7 AL (ex: user breakpoint, or other breakpoint visible at the SDM level) instead of a breakpoint which may be created by another component (for example an internal breakpoint used for stepping).
- CompilerId
- DkmCompilerId
[In] Identifies the source language (ex: C#) and compiler vendor (ex: Microsoft) that the breakpoint should bind against. 'LanguageId' may be left as Guid.Empty to indicate that the breakpoint should bind against all languages. 'VendorId' is nearly always left as Guid.Empty, which indicates that only the language is known (not the compiler).
- Thread
- DkmThread
[In,Optional] Thread on which this breakpoint should fire. If null, the breakpoint will fire on all threads.
- IsBarrier
- Boolean
[In] Indicates if this breakpoint is a barrier that should be set on the hardware, this works for GPU debugging.
- InstructionAddress
- DkmInstructionAddress
[In] Abstract representation of an executable code location (ex: EIP value). If the instruction address is unresolved (DkmUnknownInstructionAddress) and contains a CPU instruction, the breakpoint manager will attempt to bind the instruction if a module within that range loads.
- DataItem
- DkmDataItem
[In,Optional] Data object to add to the new DkmPendingAddressBreakpoint instance. Pass 'null' in the case that the caller doesn't need to add a data item.
Returns
[Out] Result of this method call.