DkmStackWalkFrame.Create 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>)
Create 新的 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.DkmStackWalkFramePublic 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參數
- Thread
- DkmThread
[In]這個堆疊框架所在的線程。
- InstructionAddress
- DkmInstructionAddress
[In，Optional]此框架的指示。 這可以省略批注框架。
- FrameBase
- UInt64
[In]框架的基底堆疊指標。 這由 SDM 用來排序框架，堆疊合併會用來評估逐步解說進度，因此即使已標註的框架也需要此值。 只有在偵錯程式堆疊損毀時，此值才應該無效。
- FrameSize
- UInt32
[In]此框架所耗用堆疊的位元元數目。 這個值將會是批注框架的零，如果值未知則為零。
- Flags
- DkmStackWalkFrameFlags
[In]標幟 DkmStackWalkFrame 的屬性。
- Description
- String
[In，Optional]顯示在呼叫堆疊視窗中的框架描述。 這應該提供給批注框架。
- Registers
- DkmFrameRegisters
[In，Optional]已逐步解說框架的緩存器。 這些應該提供給未批注的畫面。
- Annotations
- ReadOnlyCollection<DkmStackWalkFrameAnnotation>
[In，Optional]堆疊框架註釋的唯讀集合。 這些是由回溯器所定義，且專屬於該回溯器。 例如，使用方式是如何將內嵌框架數據從內嵌堆疊篩選傳遞至格式器。
傳回
[Out]這個方法呼叫的結果。
適用於
Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>, DkmModuleInstance, DkmAsyncStackWalkContext, DkmStackWalkFrameData)
Create 新的 DkmStackWalkFrame 物件實例。
此 API 是在 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.DkmStackWalkFramePublic 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參數
- Thread
- DkmThread
[In]這個堆疊框架所在的線程。
- InstructionAddress
- DkmInstructionAddress
[In，Optional]此框架的指示。 這可以省略批注框架。
- FrameBase
- UInt64
[In]框架的基底堆疊指標。 這由 SDM 用來排序框架，堆疊合併會用來評估逐步解說進度，因此即使已標註的框架也需要此值。 只有在偵錯程式堆疊損毀時，此值才應該無效。
- FrameSize
- UInt32
[In]此框架所耗用堆疊的位元元數目。 這個值將會是批注框架的零，如果值未知則為零。
- Flags
- DkmStackWalkFrameFlags
[In]標幟 DkmStackWalkFrame 的屬性。
- Description
- String
[In，Optional]顯示在呼叫堆疊視窗中的框架描述。 這應該提供給批注框架。
- Registers
- DkmFrameRegisters
[In，Optional]已逐步解說框架的緩存器。 這些應該提供給未批注的畫面。
- Annotations
- ReadOnlyCollection<DkmStackWalkFrameAnnotation>
[In，Optional]堆疊框架註釋的唯讀集合。 這些是由回溯器所定義，且專屬於該回溯器。 例如，使用方式是如何將內嵌框架數據從內嵌堆疊篩選傳遞至格式器。
- AnnotatedModule
- DkmModuleInstance
[In，Optional]如果我們有標註的框架，請指定要與此框架建立關聯的選擇性模組實例。 如果有，使用者在呼叫堆疊視窗中以滑鼠右鍵按兩下此框架，即可載入此模組的二進位檔或符號。 這是非批注框架的 NULL。
- AsyncContext
- DkmAsyncStackWalkContext
[In，Optional]用於逐步執行異步傳回堆疊和工作建立堆疊的選擇性內容。
[In，Optional]附加至 DkmStackWalkFrame 的選擇性對象，允許元件將其他私人數據與框架產生關聯。
傳回
[Out]這個方法呼叫的結果。
適用於
Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>, DkmModuleInstance, DkmAsyncStackWalkContext, DkmStackWalkFrameData, DkmBasicInstructionSymbolInfo)
Create 新的 DkmStackWalkFrame 物件實例。
此 API 是在 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.DkmStackWalkFramePublic 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參數
- Thread
- DkmThread
[In]這個堆疊框架所在的線程。
- InstructionAddress
- DkmInstructionAddress
[In，Optional]此框架的指示。 這可以省略批注框架。
- FrameBase
- UInt64
[In]框架的基底堆疊指標。 這由 SDM 用來排序框架，堆疊合併會用來評估逐步解說進度，因此即使已標註的框架也需要此值。 只有在偵錯程式堆疊損毀時，此值才應該無效。
- FrameSize
- UInt32
[In]此框架所耗用堆疊的位元元數目。 這個值將會是批注框架的零，如果值未知則為零。
- Flags
- DkmStackWalkFrameFlags
[In]標幟 DkmStackWalkFrame 的屬性。
- Description
- String
[In，Optional]顯示在呼叫堆疊視窗中的框架描述。 這應該提供給批注框架。
- Registers
- DkmFrameRegisters
[In，Optional]已逐步解說框架的緩存器。 這些應該提供給未批注的畫面。
- Annotations
- ReadOnlyCollection<DkmStackWalkFrameAnnotation>
[In，Optional]堆疊框架註釋的唯讀集合。 這些是由回溯器所定義，且專屬於該回溯器。 例如，使用方式是如何將內嵌框架數據從內嵌堆疊篩選傳遞至格式器。
- AnnotatedModule
- DkmModuleInstance
[In，Optional]如果我們有標註的框架，請指定要與此框架建立關聯的選擇性模組實例。 如果有，使用者在呼叫堆疊視窗中以滑鼠右鍵按兩下此框架，即可載入此模組的二進位檔或符號。 這是非批注框架的 NULL。
- AsyncContext
- DkmAsyncStackWalkContext
[In，Optional]用於逐步執行異步傳回堆疊和工作建立堆疊的選擇性內容。
[In，Optional]附加至 DkmStackWalkFrame 的選擇性對象，允許元件將其他私人數據與框架產生關聯。
- BasicSymbolInfo
- DkmBasicInstructionSymbolInfo
[In，Optional]包含對應至框架的 InstructionAddress 之 DkmInstructionSymbol 的基本資訊。 針對原生畫面，這會由 StackProvider 計算，再將框架傳遞至堆棧篩選器。
DkmStackFrame 一律會是 Null。
傳回
[Out]這個方法呼叫的結果。
適用於
Create(DkmThread, DkmInstructionAddress, UInt64, UInt32, DkmStackWalkFrameFlags, String, DkmFrameRegisters, ReadOnlyCollection<DkmStackWalkFrameAnnotation>, DkmModuleInstance, DkmAsyncStackWalkContext, DkmStackWalkFrameData, DkmBasicInstructionSymbolInfo, DkmStackWalkFramePriority)
Create 新的 DkmStackWalkFrame 物件實例。
此 API 是在 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.DkmStackWalkFramePublic 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參數
- Thread
- DkmThread
[In]這個堆疊框架所在的線程。
- InstructionAddress
- DkmInstructionAddress
[In，Optional]此框架的指示。 這可以省略批注框架。
- FrameBase
- UInt64
[In]框架的基底堆疊指標。 這由 SDM 用來排序框架，堆疊合併會用來評估逐步解說進度，因此即使已標註的框架也需要此值。 只有在偵錯程式堆疊損毀時，此值才應該無效。
- FrameSize
- UInt32
[In]此框架所耗用堆疊的位元元數目。 這個值將會是批注框架的零，如果值未知則為零。
- Flags
- DkmStackWalkFrameFlags
[In]標幟 DkmStackWalkFrame 的屬性。
- Description
- String
[In，Optional]顯示在呼叫堆疊視窗中的框架描述。 這應該提供給批注框架。
- Registers
- DkmFrameRegisters
[In，Optional]已逐步解說框架的緩存器。 這些應該提供給未批注的畫面。
- Annotations
- ReadOnlyCollection<DkmStackWalkFrameAnnotation>
[In，Optional]堆疊框架註釋的唯讀集合。 這些是由回溯器所定義，且專屬於該回溯器。 例如，使用方式是如何將內嵌框架數據從內嵌堆疊篩選傳遞至格式器。
- AnnotatedModule
- DkmModuleInstance
[In，Optional]如果我們有標註的框架，請指定要與此框架建立關聯的選擇性模組實例。 如果有，使用者在呼叫堆疊視窗中以滑鼠右鍵按兩下此框架，即可載入此模組的二進位檔或符號。 這是非批注框架的 NULL。
- AsyncContext
- DkmAsyncStackWalkContext
[In，Optional]用於逐步執行異步傳回堆疊和工作建立堆疊的選擇性內容。
[In，Optional]附加至 DkmStackWalkFrame 的選擇性對象，允許元件將其他私人數據與框架產生關聯。
- BasicSymbolInfo
- DkmBasicInstructionSymbolInfo
[In，Optional]包含對應至框架的 InstructionAddress 之 DkmInstructionSymbol 的基本資訊。 針對原生畫面，這會由 StackProvider 計算，再將框架傳遞至堆棧篩選器。
DkmStackFrame 一律會是 Null。
- Priority
- DkmStackWalkFramePriority
[In]堆疊逐步解說框架的優先順序。 這通常用於偵測到問題的批注畫面。
傳回
[Out]這個方法呼叫的結果。