DkmRuntimeInstructionBreakpoint.Create Method

Definition

Creates a new DkmRuntimeInstructionBreakpoint object. After creation, the breakpoint is in the disabled state, and must be explicitly enabled. The caller is responsible for closing the created object after they are done.

public:
 static Microsoft::VisualStudio::Debugger::Breakpoints::DkmRuntimeInstructionBreakpoint ^ Create(Guid SourceId, Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ InstructionAddress, bool IsBarrier, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Breakpoints.DkmRuntimeInstructionBreakpoint Create (Guid SourceId, Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress InstructionAddress, bool IsBarrier, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.Breakpoints.DkmRuntimeInstructionBreakpoint Create (Guid SourceId, Microsoft.VisualStudio.Debugger.DkmThread? Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress InstructionAddress, bool IsBarrier, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Guid * Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * bool * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Breakpoints.DkmRuntimeInstructionBreakpoint
Public Shared Function Create (SourceId As Guid, Thread As DkmThread, InstructionAddress As DkmInstructionAddress, IsBarrier As Boolean, DataItem As DkmDataItem) As DkmRuntimeInstructionBreakpoint

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).

Thread
DkmThread

[In,Optional] Thread on which this breakpoint should fire. If null, the breakpoint will fire on all threads.

InstructionAddress
DkmInstructionAddress

[In] Abstract representation of an executable code location (ex: EIP value). If resolved, an Instruction Address will be within a particular module instance. An Instruction Address is always within a particular Runtime Instance.

IsBarrier
Boolean

[In] Indicates if this instruction breakpoint works as a barrier, used in GPU debugging scenarios.

DataItem
DkmDataItem

[In,Optional] Data object to add to the new DkmRuntimeInstructionBreakpoint instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

[Out] Result of this method call.

Applies to