DkmWin32ExceptionInformation.Create Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Native

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Create a new DkmWin32ExceptionInformation object instance.

public:
 static Microsoft::VisualStudio::Debugger::Native::DkmWin32ExceptionInformation ^ Create(Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ RuntimeInstance, Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ InstructionAddress, System::UInt32 Code, Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionProcessingStage ProcessingStage, System::UInt32 ExceptionFlags, System::UInt64 ParentExceptionRecordAddress, System::UInt64 Address, System::Collections::ObjectModel::ReadOnlyCollection<System::UInt64> ^ ExceptionParameters);

public static Microsoft.VisualStudio.Debugger.Native.DkmWin32ExceptionInformation Create (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance, Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? InstructionAddress, uint Code, Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionProcessingStage ProcessingStage, uint ExceptionFlags, ulong ParentExceptionRecordAddress, ulong Address, System.Collections.ObjectModel.ReadOnlyCollection<ulong> ExceptionParameters);

static member Create : Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * uint32 * Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionProcessingStage * uint32 * uint64 * uint64 * System.Collections.ObjectModel.ReadOnlyCollection<uint64> -> Microsoft.VisualStudio.Debugger.Native.DkmWin32ExceptionInformation

Public Shared Function Create (RuntimeInstance As DkmRuntimeInstance, Thread As DkmThread, InstructionAddress As DkmInstructionAddress, Code As UInteger, ProcessingStage As DkmExceptionProcessingStage, ExceptionFlags As UInteger, ParentExceptionRecordAddress As ULong, Address As ULong, ExceptionParameters As ReadOnlyCollection(Of ULong)) As DkmWin32ExceptionInformation

Parameters

RuntimeInstance

DkmRuntimeInstance

[In] The DkmRuntimeInstance class represents an execution environment which is loaded into a DkmProcess and which contains code to be debugged.

Thread

DkmThread

[In] DkmThread represents a thread running in the target process.

InstructionAddress

DkmInstructionAddress

[In,Optional] Address where the exception occurred. This will always be present for C++ and Win32 exceptions. It may be missing from CLR exceptions or MDAs as these may originate from inside the runtime.

Code

UInt32

[In] 32-bit integer code for the exception. For Win32 exceptions, this is the code passed to RaiseException (ex:EXCEPTION_ACCESS_VIOLATION). This value is zero for exception categories that identify exceptions by string (ex: CLR).

ProcessingStage

DkmExceptionProcessingStage

[In] The debugger receives notifications from the target process at various stages within exception processing (ex: exception thrown, exception unhandled). This enumeration indicates the stage(s) for a notification.

ExceptionFlags

UInt32

[In] The exception flags. This can be either zero to indicate a continuable exception, or EXCEPTION_NONCONTINUABLE to indicate a noncontinuable exception.

ParentExceptionRecordAddress

UInt64

[In] Address within the target process where the parent EXCEPTION_RECORD pointer can be found. This is commonly zero.

Address

UInt64

[In] The address where the exception occurred.

ExceptionParameters

ReadOnlyCollection<UInt64>

[In] Parameters passed when the exception was raised. These parameters may be passed from the Kernel as part of handling a hardware fault (ex: access violation), or they may be passed from kernel32!RaiseException for software exceptions.

Returns

DkmWin32ExceptionInformation

[Out] Result of this method call.