DkmVisualizedExpression.GetChildrenCallback Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Evaluation

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

This method allows a visualizer addin use the expression evaluator for expansion. The evaluation result contained within the visualized expression must have come from the expression evaluator via EvaluateExpressionCallback.

public:
 void GetChildrenCallback(Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResult ^ DefaultEvaluationResult, int InitialRequestSize, Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionContext ^ InspectionContext, [Runtime::InteropServices::Out] cli::array <Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResult ^> ^ % InitialChildren, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultEnumContext ^ % EnumContext);

public void GetChildrenCallback (Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResult DefaultEvaluationResult, int InitialRequestSize, Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext InspectionContext, out Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResult[] InitialChildren, out Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultEnumContext EnumContext);

member this.GetChildrenCallback : Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResult * int * Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext * DkmEvaluationResult[] * DkmEvaluationResultEnumContext -> unit

Public Sub GetChildrenCallback (DefaultEvaluationResult As DkmEvaluationResult, InitialRequestSize As Integer, InspectionContext As DkmInspectionContext, ByRef InitialChildren As DkmEvaluationResult(), ByRef EnumContext As DkmEvaluationResultEnumContext)

Parameters

DefaultEvaluationResult

DkmEvaluationResult

[In] The evaluation result returned from the expression evaluator for this expression. The expression evaluator can only control the expansion of evaluations it understands.

InitialRequestSize

Int32

[In] The initial number of children that the caller would like returned. This value can be zero if no children will be initially returned. This value may be larger than the number of children that this expression has, in which case all children should be returned. Very large or negative values should not be used as arrays can have extremely large sizes which would cause out-of-memory if all elements were requested.

InspectionContext

DkmInspectionContext

[In] The inspection context to use for computing the children. This may differ from the original inspection context with respect to settings, such as radix, evaluation flags, or timeout.

InitialChildren

DkmEvaluationResult[]

[Out] The initial children to return. Each child must be closed by the caller when the caller is done.

EnumContext

DkmEvaluationResultEnumContext

[Out] Context object used to enumerate the children. This object must be closed by the caller of this API when enumeration is complete.