DkmRuntimeInstructionBreakpoint.TryPushConditionToTargetDevice Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Breakpoints

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Overloads

TryPushConditionToTargetDevice(DkmCompiledInspectionQuery, DkmBreakpointConditionOperator)

This tries to push the associated condition on the specified runtime instruction breakpoint to the target. This is useful for GPU debugging since testing the condition on the target (GPU hardware or VSD3D ref) is much more efficient than doing it in the debugger. Once this method succeeds, breakpoint event will only be received by the debugger when the condition tests to be true on the debuggee; if it fails, the debugger can still test the condition.

TryPushConditionToTargetDevice(DkmWorkList, DkmCompiledInspectionQuery, DkmBreakpointConditionOperator, DkmCompletionRoutine<DkmTryPushConditionToTargetDeviceAsyncResult>)

This tries to push the associated condition on the specified runtime instruction breakpoint to the target. This is useful for GPU debugging since testing the condition on the target (GPU hardware or VSD3D ref) is much more efficient than doing it in the debugger. Once this method succeeds, breakpoint event will only be received by the debugger when the condition tests to be true on the debuggee; if it fails, the debugger can still test the condition. This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.

TryPushConditionToTargetDevice(DkmCompiledInspectionQuery, DkmBreakpointConditionOperator)

This tries to push the associated condition on the specified runtime instruction breakpoint to the target. This is useful for GPU debugging since testing the condition on the target (GPU hardware or VSD3D ref) is much more efficient than doing it in the debugger. Once this method succeeds, breakpoint event will only be received by the debugger when the condition tests to be true on the debuggee; if it fails, the debugger can still test the condition.

public:
 void TryPushConditionToTargetDevice(Microsoft::VisualStudio::Debugger::Evaluation::DkmCompiledInspectionQuery ^ CompiledCondition, Microsoft::VisualStudio::Debugger::Breakpoints::DkmBreakpointConditionOperator ConditionOperator);

public:
 void TryPushConditionToTargetDevice(Microsoft::VisualStudio::Debugger::Evaluation::DkmCompiledInspectionQuery ^ CompiledCondition, Microsoft::VisualStudio::Debugger::Breakpoints::DkmBreakpointConditionOperator ConditionOperator);

void TryPushConditionToTargetDevice(Microsoft::VisualStudio::Debugger::Evaluation::DkmCompiledInspectionQuery const & CompiledCondition, Microsoft::VisualStudio::Debugger::Breakpoints::DkmBreakpointConditionOperator ConditionOperator);

public void TryPushConditionToTargetDevice (Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery CompiledCondition, Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointConditionOperator ConditionOperator);

member this.TryPushConditionToTargetDevice : Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery * Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointConditionOperator -> unit

Public Sub TryPushConditionToTargetDevice (CompiledCondition As DkmCompiledInspectionQuery, ConditionOperator As DkmBreakpointConditionOperator)

Parameters

CompiledCondition

DkmCompiledInspectionQuery

[In] Compiled query used to evaluate the condition.

ConditionOperator

DkmBreakpointConditionOperator

[In] Operator to use when evaluating the condition.

TryPushConditionToTargetDevice(DkmWorkList, DkmCompiledInspectionQuery, DkmBreakpointConditionOperator, DkmCompletionRoutine<DkmTryPushConditionToTargetDeviceAsyncResult>)

This tries to push the associated condition on the specified runtime instruction breakpoint to the target. This is useful for GPU debugging since testing the condition on the target (GPU hardware or VSD3D ref) is much more efficient than doing it in the debugger. Once this method succeeds, breakpoint event will only be received by the debugger when the condition tests to be true on the debuggee; if it fails, the debugger can still test the condition.

This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.

public:
 void TryPushConditionToTargetDevice(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, Microsoft::VisualStudio::Debugger::Evaluation::DkmCompiledInspectionQuery ^ CompiledCondition, Microsoft::VisualStudio::Debugger::Breakpoints::DkmBreakpointConditionOperator ConditionOperator, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Breakpoints::DkmTryPushConditionToTargetDeviceAsyncResult> ^ CompletionRoutine);

public void TryPushConditionToTargetDevice (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery CompiledCondition, Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointConditionOperator ConditionOperator, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmTryPushConditionToTargetDeviceAsyncResult> CompletionRoutine);

member this.TryPushConditionToTargetDevice : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery * Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointConditionOperator * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmTryPushConditionToTargetDeviceAsyncResult> -> unit

Public Sub TryPushConditionToTargetDevice (WorkList As DkmWorkList, CompiledCondition As DkmCompiledInspectionQuery, ConditionOperator As DkmBreakpointConditionOperator, CompletionRoutine As DkmCompletionRoutine(Of DkmTryPushConditionToTargetDeviceAsyncResult))

Parameters

WorkList

DkmWorkList

WorkList to append the new work item to.

CompiledCondition

DkmCompiledInspectionQuery

[In] Compiled query used to evaluate the condition.

ConditionOperator

DkmBreakpointConditionOperator

[In] Operator to use when evaluating the condition.

CompletionRoutine

DkmCompletionRoutine<DkmTryPushConditionToTargetDeviceAsyncResult>

Routine to fire when the request is complete. If the request is successfully appended to the work list, this will always fire (including when the operation is canceled). This will never fire if appending the work item fails.