Debugging Tools for Windows

DEBUG_REQUEST_EXT_TYPED_DATA_ANSI

The DEBUG_REQUEST_EXT_TYPED_DATA_ANSI Request operation performs a variety of different sub-operations that aid in the interpretation of typed data.

Parameters

InBuffer
Specifies the EXT_TYPED_DATA structure that determines the sub-operation to perform. This EXT_TYPED_DATA structure contains the input parameters for that sub-operation along with any (optional) additional data. The additional data is included in InBuffer after the EXT_TYPED_DATA structure. The size of InBuffer is the total size of the buffer that contains the EXT_TYPED_DATA structure and the additional data. See EXT_TYPED_DATA for details on this structure and how to include the additional data.

The following sub-operations are supported.

Sub-Operation Description
EXT_TDOP_COPY Makes a copy of a typed data description.
EXT_TDOP_RELEASE Releases a typed data description.
EXT_TDOP_SET_FROM_EXPR Returns the value of an expression.
EXT_TDOP_SET_FROM_U64_EXPR Returns the value of an expression. An optional address can be provided as a parameter to the expression.
EXT_TDOP_GET_FIELD Returns a member of a structure.
EXT_TDOP_EVALUATE Returns the value of an expression. An optional value can be provided as a parameter to the expression.
EXT_TDOP_GET_TYPE_NAME Returns the type name for typed data.
EXT_TDOP_OUTPUT_TYPE_NAME Prints the type name for typed data.
EXT_TDOP_OUTPUT_SIMPLE_VALUE Prints the value of typed data.
EXT_TDOP_OUTPUT_FULL_VALUE Prints the type and value for typed data.
EXT_TDOP_HAS_FIELD Determines if a structure contains a specified member.
EXT_TDOP_GET_FIELD_OFFSET Returns the offset of a member within a structure.
EXT_TDOP_GET_ARRAY_ELEMENT Returns an element from an array.
EXT_TDOP_GET_DEREFERENCE Dereferences a pointer, returning the value it points to.
EXT_TDOP_GET_TYPE_SIZE Returns the size of the specified typed data.
EXT_TDOP_OUTPUT_TYPE_DEFINITION Prints the definition of the type for the specified typed data.
EXT_TDOP_GET_POINTER_TO Returns a new typed data description that represents a pointer to specified typed data.
EXT_TDOP_SET_FROM_TYPE_ID_AND_U64 Creates a typed data description from a type and memory location.
EXT_TDOP_SET_PTR_FROM_TYPE_ID_AND_U64 Creates a typed data description that represents a pointer to a specified memory location with specified type.

OutBuffer
Receives the EXT_TYPED_DATA structure that contains the output parameters and any additional data for the sub-operation. As with InBuffer, the size of OutBuffer is the total size of the buffer that contains the EXT_TYPED_DATA structure and any additional data.

The DEBUG_REQUEST_EXT_TYPED_DATA_ANSI operation will initially copy InBuffer into OutBuffer and then modify the contents of OutBuffer in place. This means that OutBuffer will be populated with the input parameters of the EXT_TYPED_DATA and any additional data that was provided in InBuffer. It also means that the size of OutBuffer must be at least as big as the size of InBuffer.

Return Value

S_OK
The operation was successful.

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

The value returned by this operation is also stored in the Status member of OutBuffer.

Comments

The sub-operation performed by the DEBUG_REQUEST_EXT_TYPED_DATA_ANSI Request operation is determined by the Operation member of the EXT_TYPED_DATA structure, which takes a value in the EXT_TDOP enumeration.

See Also

EXT_TYPED_DATA, EXT_TDOP, Request

Build machine: CAPEBUILD