Debugging Tools for Windows

GetPseudoValues

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

HRESULT
  IDebugRegisters2::GetPseudoValues(
    IN ULONG  Source,
    IN ULONG  Count,
    IN OPTIONAL PULONG  Indices,
    IN ULONG  Start,
    OUT PDEBUG_VALUE  Values
    );

Parameters

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.

Count
Specifies the number of pseudo-registers whose values are being requested.
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.
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.
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

S_OK
The method was successful.

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

Interface Version

GetPseudoValues is available in IDebugRegisters2 and later versions.

Comments

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

Requirements

Headers: Defined in DbgEng.h. Include DbgEng.h.

See Also

DEBUG_VALUE, SetPseudoValues

Build machine: CAPEBUILD