IDebugFailureAnalysis2 interface

When the !analyze debugger command runs, the analysis engine can load and run extension analysis plug-ins. The analysis engine creates a DebugFailureAnalysis object to organize data that is related to a particular analysis session.

An extension analysis plug-in can access a DebugFailureAnalysis object through an IDebugFailureAnalysis2 interface. The plug-in can inspect, alter, and enhance the information created by the default analysis. For more information, see Writing an Analysis Extension Plug-in to Extend !analyze.

Members

The IDebugFailureAnalysis2 interface inherits from the IUnknown interface. IDebugFailureAnalysis2 also has these types of members:

Methods

The IDebugFailureAnalysis2 interface has these methods.

MethodDescription
AddBuffer

The AddBuffer method adds a new FA entry to a DebugFailureAnalysis object, and writes the bytes from a specified buffer to the data block of the new FA entry.

AddExtensionCommand

The AddExtensionCommand method adds a new FA entry to a DebugFailureAnalysis object and sets the data block of the FA entry to a specified debugger command.

AddString

The AddString method adds a new FA entry to a DebugFailureAnalysis object and sets the data block of the FA entry to a specified string.

AddUlong

The AddUlong method adds a new FA entry to a DebugFailureAnalysis object and sets the data block of the FA entry to a specified ULONG value.

AddUlong64

The AddUlong64 method adds a new FA entry to a DebugFailureAnalysis object and sets the data block of the FA entry to a specified 64-bit value.

Get

The Get method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag.

GetBuffer

The GetBuffer method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it gets the entry's data block.

GetDebugFATagControl

The GetDebugFATagControl method gets a pointer to an IDebugFAEntryTags interface, which provides access to the tags in a DebugFailureAnalysisTags object.

GetFailureClass

The GetFailureClass method gets the failure class of a DebugFailureAnalysis object. The failure class indicates whether the debugging session that created the DebugFailureAnalysis object is a kernel mode session or a user mode session.

GetFailureCode

The GetFailureCode method gets the bug check code or exception code of a DebugFailureAnalysis object.

GetFailureType

The GetFailureType method gets the failure type of a DebugFailureAnalysis object. The failure type indicates whether the code being analyzed was running in kernel mode or user mode.

GetNext

The GetNext method searches a DebugFailureAnalysis object for the next FA entry, after a given FA entry, that satisfies conditions specified by the Tag and TagMask parameters.

GetString

The GetString method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it gets the ANSI string value from the entry's data block.

GetUlong

The GetUlong method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it gets the ULONG value from the entry's data block.

GetUlong64

The GetUlong64 method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it gets the ULONG64 value from the entry's data block.

NextEntry

The NextEntry method gets the next FA entry, after a given FA entry, in a DebugFailureAnalysis object.

SetBuffer

The SetBuffer method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it overwrites the data block of the FA entry with the bytes in a specified buffer.

SetExtensionCommand

The SetExtensionCommand method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it sets (overwrites) the data block of the FA entry to a specified extension command string.

SetString

The SetString method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it sets (overwrites) the data block of the FA entry to a specified string value.

SetUlong

The SetUlong method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it sets (overwrites) the data block of the FA entry to a specified ULONG value.

SetUlong64

The SetUlong64 method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it sets (overwrites) the data block of the FA entry to a specified ULONG64 value.

 

Requirements

Header

Extsfns.h

See also

Writing an Analysis Extension Plug-in to Extend !analyze
_EFN_Analyze
!analyze

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft