Udostępnij przez

DkmCustomExceptionInformation.Create Method

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.CustomRuntimes
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Package:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Create a new DkmCustomExceptionInformation object instance.

public:
 static Microsoft::VisualStudio::Debugger::CustomRuntimes::DkmCustomExceptionInformation ^ Create(Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ RuntimeInstance, Guid ExceptionCategory, Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ InstructionAddress, System::String ^ Name, System::UInt32 Code, Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionProcessingStage ProcessingStage, Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionInformation ^ ImplementationException, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ AdditionalInformation);
public static Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomExceptionInformation Create (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance, Guid ExceptionCategory, Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress InstructionAddress, string Name, uint Code, Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionProcessingStage ProcessingStage, Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionInformation ImplementationException, System.Collections.ObjectModel.ReadOnlyCollection<byte> AdditionalInformation);
public static Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomExceptionInformation Create (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance, Guid ExceptionCategory, Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? InstructionAddress, string? Name, uint Code, Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionProcessingStage ProcessingStage, Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionInformation? ImplementationException, System.Collections.ObjectModel.ReadOnlyCollection<byte>? AdditionalInformation);
static member Create : Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Guid * Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * string * uint32 * Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionProcessingStage * Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionInformation * System.Collections.ObjectModel.ReadOnlyCollection<byte> -> Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomExceptionInformation
Public Shared Function Create (RuntimeInstance As DkmRuntimeInstance, ExceptionCategory As Guid, Thread As DkmThread, InstructionAddress As DkmInstructionAddress, Name As String, Code As UInteger, ProcessingStage As DkmExceptionProcessingStage, ImplementationException As DkmExceptionInformation, AdditionalInformation As ReadOnlyCollection(Of Byte)) As DkmCustomExceptionInformation

Parameters

RuntimeInstance
DkmRuntimeInstance

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

ExceptionCategory
Guid

[In] Indicates the type of exception.

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.

Name
String

[In,Optional] Name of the exception. For C++ or CLR exceptions, this is the type name. This value will be null for exception categories that identify exceptions by code (ex: Win32).

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.

ImplementationException
DkmExceptionInformation

[In,Optional] Information about the underlying exception used to implement a higher level exception. For example, CLR and C++ exceptions may be implemented on top of Win32 exceptions. So this may store the DkmWin32ExceptionInformation for CLR or C++ exceptions.

AdditionalInformation
ReadOnlyCollection<Byte>

[In,Optional] Additional data about this custom exception. Format is defined by the custom exception type.

Returns

DkmCustomExceptionInformation

[Out] Result of this method call.

Applies to