DkmInstructionSymbol.GetAlternateSourcePosition Method

Definition

Returns an alternate source file position (ex: example.cs, line 12) for this instruction symbol. This is currently used in source map scenarios to return the original (unmapped) source location. This API will be called by the debugger UI in cases where the primary source location cannot be found.

Location constraint: API must be called from an IDE component (component level > 100,000).

This API was introduced in Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3).

public:
 Microsoft::VisualStudio::Debugger::Symbols::DkmSourcePosition ^ GetAlternateSourcePosition(Microsoft::VisualStudio::Debugger::Symbols::DkmSourcePositionFlags Flags);
public:
 Microsoft::VisualStudio::Debugger::Symbols::DkmSourcePosition ^ GetAlternateSourcePosition(Microsoft::VisualStudio::Debugger::Symbols::DkmSourcePositionFlags Flags);
Microsoft::VisualStudio::Debugger::Symbols::DkmSourcePosition GetAlternateSourcePosition(Microsoft::VisualStudio::Debugger::Symbols::DkmSourcePositionFlags Flags);
public Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition GetAlternateSourcePosition (Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePositionFlags Flags);
member this.GetAlternateSourcePosition : Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePositionFlags -> Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition
Public Function GetAlternateSourcePosition (Flags As DkmSourcePositionFlags) As DkmSourcePosition

Parameters

Flags
DkmSourcePositionFlags

[In] Flags which affect the behavior of 'GetSourcePosition'.

Returns

[Out] Associated source location for the instruction.

Exceptions

Symbol provider doesn't support mapping this specified instruction to an alternate location.

Applies to