Expand Minimize

IDebugControl interface

Members

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

Methods

The IDebugControl interface has these methods.

MethodDescription
AddBreakpoint

Creates a new breakpoint for the current target.

AddEngineOptions

Turns on some of the debugger engine's options.

AddExtension

Loads an extension library into the debugger engine.

Assemble

Assembles a single processor instruction. The assembled instruction is placed in the target's memory.

CallExtension

Calls a debugger extension.

CloseLogFile

Closes the currently-open log file.

CoerceValue

Converts a value of one type into a value of another type.

CoerceValues

Converts an array of values into an array of values of different types.

ControlledOutput

Formats a string and sends the result to output callbacks that were registered with some of the engine's clients.

ControlledOutputVaList

Formats a string and sends the result to output callbacks that were registered with some of the engine's clients.

Disassemble

Disassembles a processor instruction in the target's memory.

Evaluate

Evaluates an expression, returning the result.

Execute

Executes the specified debugger commands.

ExecuteCommandFile

Opens the specified file and executes the debugger commands that are contained within.

GetActualProcessorType

Returns the processor type of the physical processor of the computer that is running the target.

GetBreakpointById

Returns the breakpoint with the specified breakpoint ID.

GetBreakpointByIndex

Returns the breakpoint located at the specified index.

GetBreakpointParameters

Returns the parameters of one or more breakpoints.

GetCodeLevel

Returns the current code level and is mainly used when stepping through code.

GetDebuggeeType

Describes the nature of the current target.

GetDisassembleEffectiveOffset

Returns the address of the last instruction disassembled using Disassemble.

GetEffectiveProcessorType

Returns the effective processor type of the processor of the computer that is running the target.

GetEngineOptions

Returns the engine's options.

GetEventFilterCommand

Returns the debugger command that the engine will execute when a specified event occurs.

GetEventFilterText

Returns a short description of an event for a specific filter.

GetExceptionFilterParameters

Returns the parameters for exception filters specified by exception codes or by index.

GetExceptionFilterSecondCommand

Returns the command that will be executed by the debugger engine upon the second chance of a specified exception.

GetExecutingProcessorType

Returns the executing processor type for the processor for which the last event occurred.

GetExecutionStatus

Returns information about the execution status of the debugger engine.

GetExtensionByPath

Returns the handle for an already loaded extension library.

GetExtensionFunction

Returns a pointer to an extension function from an extension library.

GetInterrupt

Checks whether a user interrupt was issued.

GetInterruptTimeout

Returns the number of seconds that the engine will wait when requesting a break into the debugger.

GetLastEventInformation

Returns information about the last event that occurred in a target.

GetLogFile

Returns the name of the currently open log file.

GetLogMask

Returns the output mask for the currently open log file. HRESULT

GetNearInstruction

Returns the location of a processor instruction relative to a given location.

GetNotifyEventHandle

Receives the handle of the event that will be signaled after the next exception in a target.

GetNumberBreakpoints

Returns the number of breakpoints for the current process.

GetNumberEventFilters

Returns the number of event filters currently used by the engine.

GetNumberPossibleExecutingProcessorTypes

Returns the number of processor types that are supported by the computer running the current target.

GetNumberProcessors

Returns the number of processors on the computer running the current target.

GetNumberSupportedProcessorTypes

Returns the number of processor types supported by the engine.

GetPageSize

Returns the page size for the effective processor mode.

GetPossibleExecutingProcessorTypes

Returns the processor types that are supported by the computer running the current target.

GetProcessorTypeNames

Returns the full name and abbreviated name of the specified processor type.

GetPromptText

Returns the standard prompt text that will be prepended to the formatted output specified in the OutputPrompt and OutputPromptVaList methods.

GetRadix

Returns the default radix (number base) used by the debugger engine when it evaluates and displays MASM expressions, and when it displays symbol information.

GetReturnOffset

Returns the return address for the current function.

GetSpecificFilterArgument

Returns the value of filter argument for thespecific filters that have an argument.

GetSpecificFilterParameters

Returns the parameters for specific event filters.

GetStackTrace

Returns the frames at the top of the specified call stack.

GetSupportedProcessorTypes

Returns the processor types supported by the debugger engine.

GetSystemErrorControl

Returns the control values for handling system errors.

GetSystemVersion

Returns information that identifies the operating system on the computer that is running the current target.

GetTextMacro

Returns the value of a fixed-name alias.

GetWindbgExtensionApis32

GetWindbgExtensionApis64

returns a structure that facilitates using the WdbgExts API.

Input

Requests an input string from the debugger engine.

IsPointer64Bit

Determines if the effective processor uses 64-bit pointers.

OpenLogFile

Opens a log file that will receive output from the client objects.

Output

Formats a string and sends the result to output callbacks that have been registered with the engine's clients.

OutputCurrentState

Prints the current state of the current target to the debugger console.

OutputDisassembly

Disassembles a processor instruction and sends the disassembly to the output callbacks.

OutputDisassemblyLines

Disassembles several processor instructions and sends the resulting assembly instructions to the output callbacks.

OutputPrompt

Formats and sends a user prompt to the output callback objects.

OutputPromptVaList

Formats and sends a user prompt to the output callback objects.

OutputStackTrace

Outputs either the supplied stack frame or the current stack frames.

OutputVaList

Formats a string and sends the result to the output callbacks that are registered with the engine's clients.

OutputVersionInformation

Prints version information about the debugger engine to the debugger console.

ReadBugCheckData

Reads the kernel bug check code and related parameters.

RemoveBreakpoint

Removes a breakpoint.

RemoveEngineOptions

Turns off some of the engine's options.

RemoveExtension

Unloads an extension library.

ReturnInput

This method is used by IDebugInputCallbacks objects to send an input string to the engine following a request for input.

SetCodeLevel

Sets the current code level and is mainly used when stepping through code.

SetEffectiveProcessorType

Sets the effective processor type of the processor of the computer that is running the target.

SetEngineOptions

Changes the engine's options.

SetEventFilterCommand

Sets a debugger command for the engine to execute when a specified event occurs.

SetExceptionFilterParameters

Changes the break status and handling status for some exception filters.

SetExceptionFilterSecondCommand

Sets the command that will be executed by the debugger engine on the second chance of a specified exception.

SetExecutionStatus

Requests that the debugger engine enter an executable state. Actual execution will not occur until the next time WaitForEvent is called.

SetInterrupt

Registers a user interrupt or breaks into the debugger.

SetInterruptTimeout

Sets the number of seconds that the debugger engine should wait when requesting a break into the debugger.

SetLogMask

Sets the output mask for the currently open log file.

SetNotifyEventHandle

Sets the event that will be signaled after the next exception in a target.

SetRadix

Sets the default radix (number base) used by the debugger engine when it evaluates and displays MASM expressions, and when it displays symbol information.

SetSpecificFilterArgument

Sets the value of filter argument for the specific filters that can have an argument.

SetSpecificFilterParameters

Changes the break status and handling status for some specific event filters.

SetSystemErrorControl

Sets the control values for handling system errors.

SetTextMacro

Sets the value of a fixed-name alias.

WaitForEvent

Waits for an event that breaks into the debugger engine application.

 

Requirements

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugControl2
IDebugControl3
IDebugControl4

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft