DkmInstructionSymbol.GetAlternateSourcePosition 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.
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.