Udostępnij za pośrednictwem

DkmStackWalkFrame.Create Metoda

  • Odwołanie

Definicja

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

Przeciążenia

Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>)

Twórca nowe wystąpienie obiektu DkmStackWalkFrame.
Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>, DkmModuleInstance, DkmAsyncStackWalkContext, DkmStackWalkFrameData)

Twórca nowe wystąpienie obiektu DkmStackWalkFrame.

Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>, DkmModuleInstance, DkmAsyncStackWalkContext, DkmStackWalkFrameData, DkmBasicInstructionSymbolInfo)

Twórca nowe wystąpienie obiektu DkmStackWalkFrame.

Ten interfejs API został wprowadzony w programie Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>, DkmModuleInstance, DkmAsyncStackWalkContext, DkmStackWalkFrameData, DkmBasicInstructionSymbolInfo, DkmStackWalkFramePriority)

Twórca nowe wystąpienie obiektu DkmStackWalkFrame.

Ten interfejs API został wprowadzony w programie Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5).

Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>)

Twórca nowe wystąpienie obiektu DkmStackWalkFrame.

public:
 static Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ Create(Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ InstructionAddress, System::UInt64 FrameBase, System::UInt32 FrameSize, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrameFlags Flags, System::String ^ Description, Microsoft::VisualStudio::Debugger::CallStack::DkmFrameRegisters ^ Registers, System::Collections::ObjectModel::ReadOnlyCollection<Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrameAnnotation ^> ^ Annotations);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Create (Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress InstructionAddress, ulong FrameBase, uint FrameSize, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags Flags, string Description, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters Registers, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation> Annotations);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Create (Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? InstructionAddress, ulong FrameBase, uint FrameSize, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags Flags, string? Description, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters? Registers, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation>? Annotations);
static member Create : Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * uint64 * uint32 * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags * string * Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation> -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame
Public Shared Function Create (Thread As DkmThread, InstructionAddress As DkmInstructionAddress, FrameBase As ULong, FrameSize As UInteger, Flags As DkmStackWalkFrameFlags, Description As String, Registers As DkmFrameRegisters, Annotations As ReadOnlyCollection(Of DkmStackWalkFrameAnnotation)) As DkmStackWalkFrame

Parametry

Thread
DkmThread

[W] Wątek, na który jest włączona ta ramka stosu.

InstructionAddress
DkmInstructionAddress

[In,Optional] Instrukcja tej ramki. Można to pominąć w przypadku ramek z adnotacjami.

FrameBase
UInt64

[W] Podstawowy wskaźnik stosu ramki. Jest to używane przez SDM do sortowania ramki i jest używane przez połączenie stosu do oceny postępu chodzenia, więc ta wartość jest wymagana nawet w przypadku ramek z adnotacjami. Ta wartość powinna być nieprawidłowa tylko w przypadku uszkodzenia stosu debuggee.

FrameSize
UInt32

[W] Liczba bajtów stosu używanego przez tę ramkę. Ta wartość będzie równa zero dla ramek z adnotacjami lub jeśli wartość jest nieznana.

Flags
DkmStackWalkFrameFlags

[W] Flaguje właściwości elementu DkmStackWalkFrame.

Description
String

[In,Optional] Opis ramki, która będzie wyświetlana w oknie stosu wywołań. Należy to podać dla ramek z adnotacjami.

Registers
DkmFrameRegisters

[In,Optional] Rejestry klatki spacerowej. Należy je podać dla ramek bez adnotacji.

Annotations
ReadOnlyCollection<DkmStackWalkFrameAnnotation>

[In,Optional] Kolekcja adnotacji ramki stosu tylko do odczytu. Są one definiowane przez odwijacza i są specyficzne dla tego odwijacza. Przykładowe użycie polega na tym, jak dane wbudowanej ramki są przekazywane z filtru stosu wbudowanego do elementu formatującego.

Zwraca

DkmStackWalkFrame

[Out] Wynik tego wywołania metody.

Dotyczy

Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>, DkmModuleInstance, DkmAsyncStackWalkContext, DkmStackWalkFrameData)

Twórca nowe wystąpienie obiektu DkmStackWalkFrame.

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

public:
 static Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ Create(Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ InstructionAddress, System::UInt64 FrameBase, System::UInt32 FrameSize, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrameFlags Flags, System::String ^ Description, Microsoft::VisualStudio::Debugger::CallStack::DkmFrameRegisters ^ Registers, System::Collections::ObjectModel::ReadOnlyCollection<Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrameAnnotation ^> ^ Annotations, Microsoft::VisualStudio::Debugger::DkmModuleInstance ^ AnnotatedModule, Microsoft::VisualStudio::Debugger::CallStack::DkmAsyncStackWalkContext ^ AsyncContext, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrameData ^ Data);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Create (Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress InstructionAddress, ulong FrameBase, uint FrameSize, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags Flags, string Description, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters Registers, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation> Annotations, Microsoft.VisualStudio.Debugger.DkmModuleInstance AnnotatedModule, Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext AsyncContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameData Data);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Create (Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? InstructionAddress, ulong FrameBase, uint FrameSize, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags Flags, string? Description, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters? Registers, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation>? Annotations, Microsoft.VisualStudio.Debugger.DkmModuleInstance? AnnotatedModule, Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext? AsyncContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameData? Data);
static member Create : Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * uint64 * uint32 * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags * string * Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation> * Microsoft.VisualStudio.Debugger.DkmModuleInstance * Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameData -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame
Public Shared Function Create (Thread As DkmThread, InstructionAddress As DkmInstructionAddress, FrameBase As ULong, FrameSize As UInteger, Flags As DkmStackWalkFrameFlags, Description As String, Registers As DkmFrameRegisters, Annotations As ReadOnlyCollection(Of DkmStackWalkFrameAnnotation), AnnotatedModule As DkmModuleInstance, AsyncContext As DkmAsyncStackWalkContext, Data As DkmStackWalkFrameData) As DkmStackWalkFrame

Parametry

Thread
DkmThread

[W] Wątek, na który jest włączona ta ramka stosu.

InstructionAddress
DkmInstructionAddress

[In,Optional] Instrukcja tej ramki. Można to pominąć w przypadku ramek z adnotacjami.

FrameBase
UInt64

[W] Podstawowy wskaźnik stosu ramki. Jest to używane przez SDM do sortowania ramki i jest używane przez połączenie stosu do oceny postępu chodzenia, więc ta wartość jest wymagana nawet w przypadku ramek z adnotacjami. Ta wartość powinna być nieprawidłowa tylko w przypadku uszkodzenia stosu debuggee.

FrameSize
UInt32

[W] Liczba bajtów stosu używanego przez tę ramkę. Ta wartość będzie równa zero dla ramek z adnotacjami lub jeśli wartość jest nieznana.

Flags
DkmStackWalkFrameFlags

[W] Flaguje właściwości elementu DkmStackWalkFrame.

Description
String

[In,Optional] Opis ramki, która będzie wyświetlana w oknie stosu wywołań. Należy to podać dla ramek z adnotacjami.

Registers
DkmFrameRegisters

[In,Optional] Rejestry klatki spacerowej. Należy je podać dla ramek bez adnotacji.

Annotations
ReadOnlyCollection<DkmStackWalkFrameAnnotation>

[In,Optional] Kolekcja adnotacji ramki stosu tylko do odczytu. Są one definiowane przez odwijacza i są specyficzne dla tego odwijacza. Przykładowe użycie polega na tym, jak dane wbudowanej ramki są przekazywane z filtru stosu wbudowanego do elementu formatującego.

AnnotatedModule
DkmModuleInstance

[In,Optional] Jeśli mamy ramkę z adnotacjami, określa opcjonalne wystąpienie modułu do skojarzenia z tą ramką. Jeśli istnieje, użytkownik będzie mógł załadować pliki binarne lub symbole dla tego modułu, klikając prawym przyciskiem myszy tę ramkę w oknie stosu wywołań. Jest to wartość NULL dla ramek bez adnotacji.

AsyncContext
DkmAsyncStackWalkContext

[In,Optional] Opcjonalny kontekst chodzenia asynchronicznych stosów powrotnych i stosów tworzenia zadań.

Data
DkmStackWalkFrameData

[In,Optional] Opcjonalny obiekt do dołączenia do elementu DkmStackWalkFrame, co umożliwia składnikom kojarzenie dodatkowych danych prywatnych z ramką.

Zwraca

DkmStackWalkFrame

[Out] Wynik tego wywołania metody.

Dotyczy

Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>, DkmModuleInstance, DkmAsyncStackWalkContext, DkmStackWalkFrameData, DkmBasicInstructionSymbolInfo)

Twórca nowe wystąpienie obiektu DkmStackWalkFrame.

Ten interfejs API został wprowadzony w programie Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).

public:
 static Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ Create(Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ InstructionAddress, System::UInt64 FrameBase, System::UInt32 FrameSize, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrameFlags Flags, System::String ^ Description, Microsoft::VisualStudio::Debugger::CallStack::DkmFrameRegisters ^ Registers, System::Collections::ObjectModel::ReadOnlyCollection<Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrameAnnotation ^> ^ Annotations, Microsoft::VisualStudio::Debugger::DkmModuleInstance ^ AnnotatedModule, Microsoft::VisualStudio::Debugger::CallStack::DkmAsyncStackWalkContext ^ AsyncContext, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrameData ^ Data, Microsoft::VisualStudio::Debugger::Symbols::DkmBasicInstructionSymbolInfo ^ BasicSymbolInfo);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Create (Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress InstructionAddress, ulong FrameBase, uint FrameSize, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags Flags, string Description, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters Registers, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation> Annotations, Microsoft.VisualStudio.Debugger.DkmModuleInstance AnnotatedModule, Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext AsyncContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameData Data, Microsoft.VisualStudio.Debugger.Symbols.DkmBasicInstructionSymbolInfo BasicSymbolInfo);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Create (Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? InstructionAddress, ulong FrameBase, uint FrameSize, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags Flags, string? Description, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters? Registers, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation>? Annotations, Microsoft.VisualStudio.Debugger.DkmModuleInstance? AnnotatedModule, Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext? AsyncContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameData? Data, Microsoft.VisualStudio.Debugger.Symbols.DkmBasicInstructionSymbolInfo? BasicSymbolInfo);
static member Create : Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * uint64 * uint32 * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags * string * Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation> * Microsoft.VisualStudio.Debugger.DkmModuleInstance * Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameData * Microsoft.VisualStudio.Debugger.Symbols.DkmBasicInstructionSymbolInfo -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame
Public Shared Function Create (Thread As DkmThread, InstructionAddress As DkmInstructionAddress, FrameBase As ULong, FrameSize As UInteger, Flags As DkmStackWalkFrameFlags, Description As String, Registers As DkmFrameRegisters, Annotations As ReadOnlyCollection(Of DkmStackWalkFrameAnnotation), AnnotatedModule As DkmModuleInstance, AsyncContext As DkmAsyncStackWalkContext, Data As DkmStackWalkFrameData, BasicSymbolInfo As DkmBasicInstructionSymbolInfo) As DkmStackWalkFrame

Parametry

Thread
DkmThread

[W] Wątek, na który jest włączona ta ramka stosu.

InstructionAddress
DkmInstructionAddress

[In,Optional] Instrukcja tej ramki. Można to pominąć w przypadku ramek z adnotacjami.

FrameBase
UInt64

[W] Podstawowy wskaźnik stosu ramki. Jest to używane przez SDM do sortowania ramki i jest używane przez połączenie stosu do oceny postępu chodzenia, więc ta wartość jest wymagana nawet w przypadku ramek z adnotacjami. Ta wartość powinna być nieprawidłowa tylko w przypadku uszkodzenia stosu debuggee.

FrameSize
UInt32

[W] Liczba bajtów stosu używanego przez tę ramkę. Ta wartość będzie równa zero dla ramek z adnotacjami lub jeśli wartość jest nieznana.

Flags
DkmStackWalkFrameFlags

[W] Flaguje właściwości elementu DkmStackWalkFrame.

Description
String

[In,Optional] Opis ramki, która będzie wyświetlana w oknie stosu wywołań. Należy to podać dla ramek z adnotacjami.

Registers
DkmFrameRegisters

[In,Optional] Rejestry klatki spacerowej. Należy je podać dla ramek bez adnotacji.

Annotations
ReadOnlyCollection<DkmStackWalkFrameAnnotation>

[In,Optional] Kolekcja adnotacji ramki stosu tylko do odczytu. Są one definiowane przez odwijacza i są specyficzne dla tego odwijacza. Przykładowe użycie polega na tym, jak dane wbudowanej ramki są przekazywane z filtru stosu wbudowanego do elementu formatującego.

AnnotatedModule
DkmModuleInstance

[In,Optional] Jeśli mamy ramkę z adnotacjami, określa opcjonalne wystąpienie modułu do skojarzenia z tą ramką. Jeśli istnieje, użytkownik będzie mógł załadować pliki binarne lub symbole dla tego modułu, klikając prawym przyciskiem myszy tę ramkę w oknie stosu wywołań. Jest to wartość NULL dla ramek bez adnotacji.

AsyncContext
DkmAsyncStackWalkContext

[In,Optional] Opcjonalny kontekst chodzenia asynchronicznych stosów powrotnych i stosów tworzenia zadań.

Data
DkmStackWalkFrameData

[In,Optional] Opcjonalny obiekt do dołączenia do elementu DkmStackWalkFrame, co umożliwia składnikom kojarzenie dodatkowych danych prywatnych z ramką.

BasicSymbolInfo
DkmBasicInstructionSymbolInfo

[In,Optional] Zawiera podstawowe informacje o obiekcie DkmInstructionSymbol odpowiadającym instrukcji ramkiAddress. W przypadku ramek natywnych zostanie to obliczone przez dostawcę StackProvider przed przekazaniem ramki do filtru stosu.

Zawsze będzie to mieć wartość null dla elementu DkmStackFrame.

Zwraca

DkmStackWalkFrame

[Out] Wynik tego wywołania metody.

Dotyczy

Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>, DkmModuleInstance, DkmAsyncStackWalkContext, DkmStackWalkFrameData, DkmBasicInstructionSymbolInfo, DkmStackWalkFramePriority)

Twórca nowego wystąpienia obiektu DkmStackWalkFrame.

Ten interfejs API został wprowadzony w programie Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5).

public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Create (Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? InstructionAddress, ulong FrameBase, uint FrameSize, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags Flags, string? Description, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters? Registers, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation>? Annotations, Microsoft.VisualStudio.Debugger.DkmModuleInstance? AnnotatedModule, Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext? AsyncContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameData? Data, Microsoft.VisualStudio.Debugger.Symbols.DkmBasicInstructionSymbolInfo? BasicSymbolInfo, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFramePriority Priority);
static member Create : Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * uint64 * uint32 * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameFlags * string * Microsoft.VisualStudio.Debugger.CallStack.DkmFrameRegisters * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameAnnotation> * Microsoft.VisualStudio.Debugger.DkmModuleInstance * Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrameData * Microsoft.VisualStudio.Debugger.Symbols.DkmBasicInstructionSymbolInfo * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFramePriority -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame
Public Shared Function Create (Thread As DkmThread, InstructionAddress As DkmInstructionAddress, FrameBase As ULong, FrameSize As UInteger, Flags As DkmStackWalkFrameFlags, Description As String, Registers As DkmFrameRegisters, Annotations As ReadOnlyCollection(Of DkmStackWalkFrameAnnotation), AnnotatedModule As DkmModuleInstance, AsyncContext As DkmAsyncStackWalkContext, Data As DkmStackWalkFrameData, BasicSymbolInfo As DkmBasicInstructionSymbolInfo, Priority As DkmStackWalkFramePriority) As DkmStackWalkFrame

Parametry

Thread
DkmThread

[W] Wątek, na który jest włączona ta ramka stosu.

InstructionAddress
DkmInstructionAddress

[In,Optional] Instrukcja tej ramki. Można to pominąć w przypadku ramek z adnotacjami.

FrameBase
UInt64

[W] Podstawowy wskaźnik stosu ramki. Jest to używane przez SDM do sortowania ramki i jest używane przez połączenie stosu do oceny postępu chodzenia, więc ta wartość jest wymagana nawet w przypadku ramek z adnotacjami. Ta wartość powinna być nieprawidłowa tylko w przypadku uszkodzenia stosu debuggee.

FrameSize
UInt32

[W] Liczba bajtów stosu używanego przez tę ramkę. Ta wartość będzie równa zero dla ramek z adnotacjami lub jeśli wartość jest nieznana.

Flags
DkmStackWalkFrameFlags

[W] Flaguje właściwości elementu DkmStackWalkFrame.

Description
String

[In,Optional] Opis ramki, która będzie wyświetlana w oknie stosu wywołań. Należy to podać dla ramek z adnotacjami.

Registers
DkmFrameRegisters

[In,Optional] Rejestry klatki spacerowej. Należy je podać dla ramek bez adnotacji.

Annotations
ReadOnlyCollection<DkmStackWalkFrameAnnotation>

[In,Optional] Kolekcja adnotacji ramki stosu tylko do odczytu. Są one definiowane przez odwijacza i są specyficzne dla tego odwijacza. Przykładowe użycie polega na tym, jak dane wbudowanej ramki są przekazywane z filtru stosu wbudowanego do elementu formatującego.

AnnotatedModule
DkmModuleInstance

[In,Optional] Jeśli mamy ramkę z adnotacjami, określa opcjonalne wystąpienie modułu do skojarzenia z tą ramką. Jeśli istnieje, użytkownik będzie mógł załadować pliki binarne lub symbole dla tego modułu, klikając prawym przyciskiem myszy tę ramkę w oknie stosu wywołań. Jest to wartość NULL dla ramek bez adnotacji.

AsyncContext
DkmAsyncStackWalkContext

[In,Optional] Opcjonalny kontekst chodzenia asynchronicznych stosów zwrotnych i stosów tworzenia zadań.

Data
DkmStackWalkFrameData

[In,Optional] Opcjonalny obiekt do dołączania do obiektu DkmStackWalkFrame, co umożliwia składnikom kojarzenie dodatkowych danych prywatnych z ramką.

BasicSymbolInfo
DkmBasicInstructionSymbolInfo

[In,Optional] Zawiera podstawowe informacje o obiekcie DkmInstructionSymbol odpowiadającym instrukcji ramkiAddress. W przypadku ramek natywnych będzie to obliczane przez dostawcę stosu przed przekazaniem ramki do filtru stosu.

Zawsze będzie to mieć wartość null dla elementu DkmStackFrame.

Priority
DkmStackWalkFramePriority

[W] Priorytet ramki stosu. Jest to zwykle używane w przypadku ramek z adnotacjami, które wykryły problem.

Zwraca

DkmStackWalkFrame

[Out] Wynik wywołania tej metody.

Dotyczy