IDebugRegisters2::GetPseudoValues method (dbgeng.h)

Article
02/22/2024

The GetPseudoValues method returns the values of a number of pseudo-registers.

Syntax

HRESULT GetPseudoValues(
  [in]           ULONG        Source,
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [out]          PDEBUG_VALUE Values
);

Parameters

[in] Source

Specifies the register source to query.

The possible values are listed in the following table.

Value	Register source
DEBUG_REGSRC_DEBUGGEE	Fetch register information from the target.
DEBUG_REGSRC_EXPLICIT	Fetch register information from the current explicit register context.
DEBUG_REGSRC_FRAME	Fetch register information from the current scope's register context. Note Stack unwinding does not guarantee accurate updating of the register context, so the scope frame's register context might not be accurate in all cases.

[in] Count

Specifies the number of pseudo-registers whose values are being requested.

[in, optional] Indices

Specifies an array of indices of pseudo-registers whose values will be returned. The size of Indices is Count. If Indices is NULL, Start is used to specify the indices instead.

[in] Start

Specifies the index of the first pseudo-register whose value will be returned. The pseudo-registers, with indices between Start and Start plus Count minus one, will be returned. Start is only used if Indices is NULL.

[out] Values

Receives the values of the specified pseudo-registers. The number of elements that this array holds is Count. See DEBUG_VALUE for a description of this parameter type.

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

For an overview of the IDebugRegisters interface and other register-related methods, see Registers.

Requirements

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