Condividi tramite

DkmStepper.Create Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.VisualStudio.Debugger.Stepping
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Pacchetto:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Overload

Create(DkmThread, DkmInstructionAddress, UInt64, DkmStepKind, DkmStepUnit, Guid, DkmSteppingCodePath, DkmStepper, DkmDataItem)

Gli oggetti DkmStepper vengono creati dai componenti che desiderano eseguire un passaggio. I passaggi a livello di utente vengono creati da AD7-AL. Per inizializzare un oggetto stepper, Enable deve essere chiamato. Gli oggetti stepper verranno attivati fino al completamento del passaggio o interrotti.
Create(DkmThread, DkmInstructionAddress, UInt64, DkmStepKind, DkmStepUnit, Guid, DkmSteppingCodePath, DkmStepper, Boolean, ReadOnlyCollection<DkmSteppingCodePath>, String, DkmDataItem)

Gli oggetti DkmStepper vengono creati dai componenti che desiderano eseguire un passaggio. I passaggi a livello di utente vengono creati da AD7-AL. Per inizializzare un oggetto stepper, Enable deve essere chiamato. Gli oggetti stepper verranno attivati fino al completamento del passaggio o interrotti.

Questa API è stata introdotta in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Create(DkmThread, DkmInstructionAddress, UInt64, DkmStepKind, DkmStepUnit, Guid, DkmSteppingCodePath, DkmStepper, DkmDataItem)

Gli oggetti DkmStepper vengono creati dai componenti che desiderano eseguire un passaggio. I passaggi a livello di utente vengono creati da AD7-AL. Per inizializzare un oggetto stepper, Enable deve essere chiamato. Gli oggetti stepper verranno attivati fino al completamento del passaggio o interrotti.

public:
 static Microsoft::VisualStudio::Debugger::Stepping::DkmStepper ^ Create(Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ StartingAddress, System::UInt64 FrameBase, Microsoft::VisualStudio::Debugger::Stepping::DkmStepKind StepKind, Microsoft::VisualStudio::Debugger::Stepping::DkmStepUnit StepUnit, Guid SourceId, Microsoft::VisualStudio::Debugger::Stepping::DkmSteppingCodePath ^ CodePath, Microsoft::VisualStudio::Debugger::Stepping::DkmStepper ^ CrossThreadParent, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Stepping.DkmStepper Create(Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress StartingAddress, ulong FrameBase, Microsoft.VisualStudio.Debugger.Stepping.DkmStepKind StepKind, Microsoft.VisualStudio.Debugger.Stepping.DkmStepUnit StepUnit, Guid SourceId, Microsoft.VisualStudio.Debugger.Stepping.DkmSteppingCodePath CodePath, Microsoft.VisualStudio.Debugger.Stepping.DkmStepper CrossThreadParent, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.Stepping.DkmStepper Create(Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? StartingAddress, ulong FrameBase, Microsoft.VisualStudio.Debugger.Stepping.DkmStepKind StepKind, Microsoft.VisualStudio.Debugger.Stepping.DkmStepUnit StepUnit, Guid SourceId, Microsoft.VisualStudio.Debugger.Stepping.DkmSteppingCodePath? CodePath, Microsoft.VisualStudio.Debugger.Stepping.DkmStepper? CrossThreadParent, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * uint64 * Microsoft.VisualStudio.Debugger.Stepping.DkmStepKind * Microsoft.VisualStudio.Debugger.Stepping.DkmStepUnit * Guid * Microsoft.VisualStudio.Debugger.Stepping.DkmSteppingCodePath * Microsoft.VisualStudio.Debugger.Stepping.DkmStepper * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Stepping.DkmStepper
Public Shared Function Create (Thread As DkmThread, StartingAddress As DkmInstructionAddress, FrameBase As ULong, StepKind As DkmStepKind, StepUnit As DkmStepUnit, SourceId As Guid, CodePath As DkmSteppingCodePath, CrossThreadParent As DkmStepper, DataItem As DkmDataItem) As DkmStepper

Parametri

Thread
DkmThread

[In] DkmThread rappresenta un thread in esecuzione nel processo di destinazione.

StartingAddress
DkmInstructionAddress

[In,Facoltativo] Indirizzo dell'istruzione del processo al momento dell'avvio di questo passaggio. Questo valore sarà NULL se il passaggio ha origine in un thread senza frame (Script & Solo gestito).

FrameBase
UInt64

[In] Base fotogramma del primo fotogramma all'inizio del passaggio. Questo valore verrà MAXUINT64 se l'oggetto StartingAddress non è stato specificato.

StepKind
DkmStepKind

[In] DkmStepKind descrive come eseguire il passaggio del thread quando viene chiamato il metodo Step.

StepUnit
DkmStepUnit

[In] DkmStepUnit descrive la granularità del passaggio quando viene chiamato il metodo Step.

SourceId
Guid

[In] Identifica l'origine di un oggetto. Gli id di origine vengono usati per abilitare il filtro negli scenari in cui più componenti possono creare istanze di una classe. Ad esempio, gli ID di origine possono essere usati per determinare se un punto di interruzione proviene da AD7 AL (ad esempio: punto di interruzione utente o altro punto di interruzione visibile a livello di SDM) anziché un punto di interruzione che può essere creato da un altro componente (ad esempio un punto di interruzione interno usato per l'esecuzione dell'istruzione).

CodePath
DkmSteppingCodePath

[In,Facoltativo] Se StepKind è StepIntoSpecific, specifica la chiamata che si sta eseguendo. In caso contrario, è NULL.

CrossThreadParent
DkmStepper

[In,Facoltativo] Se viene creato un nuovo stepper usando OnCrossThreadStepArbitration, il gestore di passaggi imposta questo campo per semplificare il passaggio del passaggio originale se il passaggio incrociato ha esito negativo o deve eseguire il fallback. Deprecato. Usare invece GetCrossThreadParent.

DataItem
DkmDataItem

[In,Facoltativo] Oggetto dati da aggiungere alla nuova istanza di DkmStepper. Passare 'null' nel caso in cui il chiamante non debba aggiungere un elemento di dati.

Restituisce

DkmStepper

[Out] Risultato di questa chiamata al metodo.

Si applica a

Create(DkmThread, DkmInstructionAddress, UInt64, DkmStepKind, DkmStepUnit, Guid, DkmSteppingCodePath, DkmStepper, Boolean, ReadOnlyCollection<DkmSteppingCodePath>, String, DkmDataItem)

Gli oggetti DkmStepper vengono creati dai componenti che desiderano eseguire un passaggio. I passaggi a livello di utente vengono creati da AD7-AL. Per inizializzare un oggetto stepper, Enable deve essere chiamato. Gli oggetti stepper verranno attivati fino al completamento del passaggio o interrotti.

Questa API è stata introdotta in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

public:
 static Microsoft::VisualStudio::Debugger::Stepping::DkmStepper ^ Create(Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ StartingAddress, System::UInt64 FrameBase, Microsoft::VisualStudio::Debugger::Stepping::DkmStepKind StepKind, Microsoft::VisualStudio::Debugger::Stepping::DkmStepUnit StepUnit, Guid SourceId, Microsoft::VisualStudio::Debugger::Stepping::DkmSteppingCodePath ^ CodePath, Microsoft::VisualStudio::Debugger::Stepping::DkmStepper ^ CrossThreadParent, bool ShouldCaptureReturnValue, System::Collections::ObjectModel::ReadOnlyCollection<Microsoft::VisualStudio::Debugger::Stepping::DkmSteppingCodePath ^> ^ CurrentCodePaths, System::String ^ CurrentMethodName, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Stepping.DkmStepper Create(Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress StartingAddress, ulong FrameBase, Microsoft.VisualStudio.Debugger.Stepping.DkmStepKind StepKind, Microsoft.VisualStudio.Debugger.Stepping.DkmStepUnit StepUnit, Guid SourceId, Microsoft.VisualStudio.Debugger.Stepping.DkmSteppingCodePath CodePath, Microsoft.VisualStudio.Debugger.Stepping.DkmStepper CrossThreadParent, bool ShouldCaptureReturnValue, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.Stepping.DkmSteppingCodePath> CurrentCodePaths, string CurrentMethodName, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.Stepping.DkmStepper Create(Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? StartingAddress, ulong FrameBase, Microsoft.VisualStudio.Debugger.Stepping.DkmStepKind StepKind, Microsoft.VisualStudio.Debugger.Stepping.DkmStepUnit StepUnit, Guid SourceId, Microsoft.VisualStudio.Debugger.Stepping.DkmSteppingCodePath? CodePath, Microsoft.VisualStudio.Debugger.Stepping.DkmStepper? CrossThreadParent, bool ShouldCaptureReturnValue, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.Stepping.DkmSteppingCodePath>? CurrentCodePaths, string? CurrentMethodName, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * uint64 * Microsoft.VisualStudio.Debugger.Stepping.DkmStepKind * Microsoft.VisualStudio.Debugger.Stepping.DkmStepUnit * Guid * Microsoft.VisualStudio.Debugger.Stepping.DkmSteppingCodePath * Microsoft.VisualStudio.Debugger.Stepping.DkmStepper * bool * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.Stepping.DkmSteppingCodePath> * string * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Stepping.DkmStepper
Public Shared Function Create (Thread As DkmThread, StartingAddress As DkmInstructionAddress, FrameBase As ULong, StepKind As DkmStepKind, StepUnit As DkmStepUnit, SourceId As Guid, CodePath As DkmSteppingCodePath, CrossThreadParent As DkmStepper, ShouldCaptureReturnValue As Boolean, CurrentCodePaths As ReadOnlyCollection(Of DkmSteppingCodePath), CurrentMethodName As String, DataItem As DkmDataItem) As DkmStepper

Parametri

Thread
DkmThread

[In] DkmThread rappresenta un thread in esecuzione nel processo di destinazione.

StartingAddress
DkmInstructionAddress

[In,Facoltativo] Indirizzo dell'istruzione del processo al momento dell'avvio di questo passaggio. Questo valore sarà NULL se il passaggio ha origine in un thread senza frame (Script & Solo gestito).

FrameBase
UInt64

[In] Base fotogramma del primo fotogramma all'inizio del passaggio. Questo valore verrà MAXUINT64 se l'oggetto StartingAddress non è stato specificato.

StepKind
DkmStepKind

[In] DkmStepKind descrive come eseguire il passaggio del thread quando viene chiamato il metodo Step.

StepUnit
DkmStepUnit

[In] DkmStepUnit descrive la granularità del passaggio quando viene chiamato il metodo Step.

SourceId
Guid

[In] Identifica l'origine di un oggetto. Gli id di origine vengono usati per abilitare il filtro negli scenari in cui più componenti possono creare istanze di una classe. Ad esempio, gli ID di origine possono essere usati per determinare se un punto di interruzione proviene da AD7 AL (ad esempio: punto di interruzione utente o altro punto di interruzione visibile a livello di SDM) anziché un punto di interruzione che può essere creato da un altro componente (ad esempio un punto di interruzione interno usato per l'esecuzione dell'istruzione).

CodePath
DkmSteppingCodePath

[In,Facoltativo] Se StepKind è StepIntoSpecific, specifica la chiamata che si sta eseguendo. In caso contrario, è NULL.

CrossThreadParent
DkmStepper

[In,Facoltativo] Se viene creato un nuovo stepper usando OnCrossThreadStepArbitration, il gestore di passaggi imposta questo campo per semplificare il passaggio del passaggio originale se il passaggio incrociato ha esito negativo o deve eseguire il fallback. Deprecato. Usare invece GetCrossThreadParent.

ShouldCaptureReturnValue
Boolean

[In] Nel debug gestito, indica se il passaggioper voleva acquisire il valore restituito durante l'esecuzione dell'istruzione. Il valore predefinito è false.

CurrentCodePaths
ReadOnlyCollection<DkmSteppingCodePath>

[In,Facoltativo] Nel debug gestito contiene tutti i percorsi di codice nell'intervallo di passaggi corrente. In caso contrario, è NULL.

CurrentMethodName
String

[In,Facoltativo] Nel debug gestito contiene il nome del metodo corrente. In caso contrario, è NULL.

DataItem
DkmDataItem

[In,Facoltativo] Oggetto dati da aggiungere alla nuova istanza di DkmStepper. Passare 'null' nel caso in cui il chiamante non debba aggiungere un elemento di dati.

Restituisce

DkmStepper

[Out] Risultato di questa chiamata al metodo.

Si applica a