Share via

DkmStepper.Create Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualStudio.Debugger.Stepping
Zestaw:
Microsoft.VisualStudio.Debugger.Engine.dll
Pakiet:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Przeciążenia

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

Obiekty DkmStepper są tworzone przez składniki, które chcą wydać krok. Schodki na poziomie użytkownika są tworzone przez usługę AD7-AL. Aby zainicjować obiekt stepper, należy wywołać funkcję Włącz. Obiekty krokowe będą żyć do momentu ukończenia kroku lub przerwania.
Create(DkmThread, DkmInstructionAddress, UInt64, DkmStepKind, DkmStepUnit, Guid, DkmSteppingCodePath, DkmStepper, Boolean, ReadOnlyCollection<DkmSteppingCodePath>, String, DkmDataItem)

Obiekty DkmStepper są tworzone przez składniki, które chcą wydać krok. Schodki na poziomie użytkownika są tworzone przez usługę AD7-AL. Aby zainicjować obiekt stepper, należy wywołać funkcję Włącz. Obiekty krokowe będą żyć do momentu ukończenia kroku lub przerwania.

Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

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

Obiekty DkmStepper są tworzone przez składniki, które chcą wydać krok. Schodki na poziomie użytkownika są tworzone przez usługę AD7-AL. Aby zainicjować obiekt stepper, należy wywołać funkcję Włącz. Obiekty krokowe będą żyć do momentu ukończenia kroku lub przerwania.

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

Parametry

Thread
DkmThread

[W] Element DkmThread reprezentuje wątek uruchomiony w procesie docelowym.

StartingAddress
DkmInstructionAddress

[In,Optional] Adres instrukcji procesu w momencie rozpoczęcia tego kroku. Będzie to wartość NULL, jeśli krok pochodzi z wątku bez ramek (skrypt & tylko zarządzany).

FrameBase
UInt64

[W] Podstawa ramki pierwszej ramki na początku kroku. Ta wartość zostanie MAXUINT64, jeśli nie określono wartości StartingAddress.

StepKind
DkmStepKind

[W] DkmStepKind opisuje sposób wykonywania kroków wątku po wywołaniu metody kroku.

StepUnit
DkmStepUnit

[W] DkmStepUnit opisuje stopień szczegółowości kroku po wywołaniu metody Step.

SourceId
Guid

[W] Identyfikuje źródło obiektu. Identyfikatory SourceId służą do włączania filtrowania w scenariuszach, gdy wiele składników może tworzyć wystąpienia klasy. Na przykład identyfikatory źródła mogą służyć do określenia, czy punkt przerwania pochodzi z usługi AD7 AL (np. punkt przerwania użytkownika lub inny punkt przerwania widoczny na poziomie SDM) zamiast punktu przerwania, który może zostać utworzony przez inny składnik (na przykład wewnętrzny punkt przerwania używany do wykonywania kroków).

CodePath
DkmSteppingCodePath

[In,Optional] Jeśli stepKind to StepIntoSpecific, określa, do którego wywołania wchodzimy. W przeciwnym razie ma wartość NULL.

CrossThreadParent
DkmStepper

[In,Optional] W przypadku utworzenia nowego kroku przy użyciu metody OnCrossThreadStepArbitration menedżer kroków ustawi to pole, aby ułatwić powrót do oryginalnego kroku, jeśli krok między wątkami zakończy się niepowodzeniem lub będzie musiał powrócić do powrotu. Przestarzałe. Zamiast tego użyj polecenia GetCrossThreadParent.

DataItem
DkmDataItem

[In,Optional] Obiekt danych do dodania do nowego wystąpienia DkmStepper. Przekaż wartość "null" w przypadku, gdy obiekt wywołujący nie musi dodawać elementu danych.

Zwraca

DkmStepper

[Out] Wynik tego wywołania metody.

Dotyczy

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

Obiekty DkmStepper są tworzone przez składniki, które chcą wydać krok. Schodki na poziomie użytkownika są tworzone przez usługę AD7-AL. Aby zainicjować obiekt stepper, należy wywołać funkcję Włącz. Obiekty krokowe będą żyć do momentu ukończenia kroku lub przerwania.

Ten interfejs API został wprowadzony w programie 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

Parametry

Thread
DkmThread

[W] Element DkmThread reprezentuje wątek uruchomiony w procesie docelowym.

StartingAddress
DkmInstructionAddress

[In,Optional] Adres instrukcji procesu w momencie rozpoczęcia tego kroku. Będzie to wartość NULL, jeśli krok pochodzi z wątku bez ramek (skrypt & tylko zarządzany).

FrameBase
UInt64

[W] Podstawa ramki pierwszej ramki na początku kroku. Ta wartość zostanie MAXUINT64, jeśli nie określono wartości StartingAddress.

StepKind
DkmStepKind

[W] DkmStepKind opisuje sposób wykonywania kroków wątku po wywołaniu metody kroku.

StepUnit
DkmStepUnit

[W] DkmStepUnit opisuje stopień szczegółowości kroku po wywołaniu metody Step.

SourceId
Guid

[W] Identyfikuje źródło obiektu. Identyfikatory SourceId służą do włączania filtrowania w scenariuszach, gdy wiele składników może tworzyć wystąpienia klasy. Na przykład identyfikatory źródła mogą służyć do określenia, czy punkt przerwania pochodzi z usługi AD7 AL (np. punkt przerwania użytkownika lub inny punkt przerwania widoczny na poziomie SDM) zamiast punktu przerwania, który może zostać utworzony przez inny składnik (na przykład wewnętrzny punkt przerwania używany do wykonywania kroków).

CodePath
DkmSteppingCodePath

[In,Optional] Jeśli stepKind to StepIntoSpecific, określa, do którego wywołania wchodzimy. W przeciwnym razie ma wartość NULL.

CrossThreadParent
DkmStepper

[In,Optional] W przypadku utworzenia nowego kroku przy użyciu metody OnCrossThreadStepArbitration menedżer kroków ustawi to pole, aby ułatwić powrót do oryginalnego kroku, jeśli krok między wątkami zakończy się niepowodzeniem lub będzie musiał powrócić do powrotu. Przestarzałe. Zamiast tego użyj polecenia GetCrossThreadParent.

ShouldCaptureReturnValue
Boolean

[W] W przypadku debugowania zarządzanego wskazuje, czy krokper chciał przechwycić wartość zwracaną podczas wykonywania kroków. Wartość domyślna to false.

CurrentCodePaths
ReadOnlyCollection<DkmSteppingCodePath>

[In,Optional] W przypadku debugowania zarządzanego zawiera wszystkie ścieżki kodu w bieżącym zakresie kroków. W przeciwnym razie ma wartość NULL.

CurrentMethodName
String

[In,Optional] W przypadku debugowania zarządzanego zawiera bieżącą nazwę metody. W przeciwnym razie ma wartość NULL.

DataItem
DkmDataItem

[In,Optional] Obiekt danych do dodania do nowego wystąpienia DkmStepper. Przekaż wartość "null" w przypadku, gdy obiekt wywołujący nie musi dodawać elementu danych.

Zwraca

DkmStepper

[Out] Wynik tego wywołania metody.

Dotyczy