IDebugControl2::OutputCurrentState method (dbgeng.h)

Article
02/22/2024

The OutputCurrentState method prints the current state of the current target to the debugger console.

Syntax

HRESULT OutputCurrentState(
  [in] ULONG OutputControl,
  [in] ULONG Flags
);

Parameters

[in] OutputControl

Specifies which clients to send the output to. For possible values see DEBUG_OUTCTL_XXX.

[in] Flags

Specifies the bit set that determines the information to print to the debugger console. Flags can be any combination of values from the following table.

Flag	Description
DEBUG_CURRENT_SYMBOL	Symbol string for the address of the current instruction.
DEBUG_CURRENT_DISASM	Disassembly of the current instruction.
DEBUG_CURRENT_REGISTERS	Current register values.
DEBUG_CURRENT_SOURCE_LINE	File name and line number of the source corresponding to the current instruction.

Alternatively, Flags can be set to DEBUG_CURRENT_DEFAULT. This value includes all of the above flags.

Return value

This method may also return error values. See Return Values for more details.

Return code	Description
S_OK	The method was successful.

Remarks

Setting the flags contained in Flags merely allows the information to be printed. The information will not always be printed (for example, it will not be printed if it is not available).

This is the same status information that is printed when breaking into the debugger.

For more information, see Target Information.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)

Share via