IDebugRegisters::OutputRegisters method (dbgeng.h)

Article
02/22/2024

The OutputRegisters method formats and sends the target's registers to the clients as output.

Syntax

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

Parameters

[in] OutputControl

Specifies which clients should be sent the output of the formatted registers. See DEBUG_OUTCTL_XXX for possible values.

[in] Flags

Specifies which set of registers to print. This can either be DEBUG_REGISTERS_DEFAULT to print commonly used registers, DEBUG_REGISTERS_ALL to print all the sets of registers, or a combination of the values listed in the following table.

Value	Description
DEBUG_REGISTERS_INT32	Print the 32-bit register set.
DEBUG_REGISTERS_INT64	Print the 64-bit register set.
DEBUG_REGISTERS_FLOAT	Print the floating-point register set.

Return value

This list does not contain all the errors that might occur. For a list of possible errors, see HRESULT Values.

Return code	Description
S_OK	The method was successful.

Remarks

The registers are formatted in a way that is specific to the target architecture's register set.

The method OutputRegisters2 performs the same task as this method but also allows the register source to be specified.

For an overview of the IDebugRegisters interface and other register-related methods, see Registers. For details on sending output to the clients, see Input and Output.

Requirements

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