DkmDisassembledInstruction.Create Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Disassembly

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Create a new DkmDisassembledInstruction object instance.

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

public:
 static Microsoft::VisualStudio::Debugger::Disassembly::DkmDisassembledInstruction ^ Create(Microsoft::VisualStudio::Debugger::DkmProcess ^ Process, System::UInt64 InstructionPointer, System::UInt32 InstructionLength, System::String ^ Address, System::String ^ AddressOffset, System::String ^ CodeBytes, System::String ^ RawOpcode, System::String ^ RawOperands, System::String ^ FormattedOpcode, System::String ^ FormattedOperands, System::String ^ Symbol, Microsoft::VisualStudio::Debugger::Symbols::DkmSourcePosition ^ DocumentPosition, System::UInt32 ByteOffset, System::Collections::ObjectModel::ReadOnlyCollection<int> ^ RegisterOperands, bool ValidInstruction);

public static Microsoft.VisualStudio.Debugger.Disassembly.DkmDisassembledInstruction Create (Microsoft.VisualStudio.Debugger.DkmProcess Process, ulong InstructionPointer, uint InstructionLength, string Address, string AddressOffset, string CodeBytes, string RawOpcode, string RawOperands, string FormattedOpcode, string FormattedOperands, string? Symbol, Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition? DocumentPosition, uint ByteOffset, System.Collections.ObjectModel.ReadOnlyCollection<int> RegisterOperands, bool ValidInstruction);

static member Create : Microsoft.VisualStudio.Debugger.DkmProcess * uint64 * uint32 * string * string * string * string * string * string * string * string * Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition * uint32 * System.Collections.ObjectModel.ReadOnlyCollection<int> * bool -> Microsoft.VisualStudio.Debugger.Disassembly.DkmDisassembledInstruction

Public Shared Function Create (Process As DkmProcess, InstructionPointer As ULong, InstructionLength As UInteger, Address As String, AddressOffset As String, CodeBytes As String, RawOpcode As String, RawOperands As String, FormattedOpcode As String, FormattedOperands As String, Symbol As String, DocumentPosition As DkmSourcePosition, ByteOffset As UInteger, RegisterOperands As ReadOnlyCollection(Of Integer), ValidInstruction As Boolean) As DkmDisassembledInstruction

Parameters

Process

DkmProcess

[In] DkmProcess represents a target process which is being debugged. The debugger debugs processes, so this is the basic unit of debugging. A DkmProcess can represent a system process or a virtual process such as minidumps.

InstructionPointer

UInt64

[In] The address of this instruction in the debuggee address space.

InstructionLength

UInt32

[In] The length of the instruction in bytes.

Address

String

[In] The formatted address of this instruction in the debuggee address space.

AddressOffset

String

[In] The address as an offset from some starting point, usually the beginning of the associated function.

CodeBytes

String

[In] The code bytes for this instruction.

RawOpcode

String

[In] The raw opcode for this instruction with no symbolic lookups.

RawOperands

String

[In] The raw operands for this instruction with no symbolic lookups.

FormattedOpcode

String

[In] The opcode for this instruction including resolved symbol names. If nothing is resolved, this is the same as RawOpcode.

FormattedOperands

String

[In] The operands for this instruction including resolved symbol names. If nothing is resolved, this is the same as RawOperands.

Symbol

String

[In,Optional] The symbol name, if any, associated with the address (public symbol, label, and so on).

DocumentPosition

DkmSourcePosition

[In,Optional] An optional reference to the document and text position this instruction belongs to in the source document.

ByteOffset

UInt32

[In] The number of bytes from the beginning of the corresponding source statement.

RegisterOperands

ReadOnlyCollection<Int32>

[In] A read only collection of CV constants representing any register arguments in the disassembled instruction.

ValidInstruction

Boolean

[In] True if this instruction was successfully disassembled. False if it is a filler instruction used by heuristic unwinders when an invalid op code is encountered. Most disassembly providers will fill the op code with question marks when this is set to true to indicate a bogus instruction.

Returns

DkmDisassembledInstruction

[Out] Result of this method call.