ddpi_stackstate_fn_add operation

The ddpi_stackstate_fn_add operation adds a pair of identify and parent handlers to support stack frame queries.

Prototype

int ddpi_stackstate_fn_add(
  Ddpi_StackState_Fn    stackstate_fn,
  Ddpi_StackState_Identify_Handler
                        identify_handler,
  Ddpi_StackState_Parent_Handler
                        parent_handler,
  Ddpi_Error*           error);

Parameters

stackstate_fn: Input. This accepts the Ddpi_StackState_Fn object.
identify_handler: Input. This accepts the stack-state handler function that will gather the information for the initial stack-frame. For example, if the stack frame conforms to the LE, then you can use ddpi_stackstate_identify_le.
parent_handler: Input. This accepts the stack-state handler function that will gather the information for the parent stack-frame. For example, if the stack frame conforms to the LE, then you can use ddpi_stackstate_parent_le.
error: See The libddpi error parameter.

Return values

The ddpi_stackstate_fn_add operation returns DW_DLV_OK when the handlers to support stackframe queries have been successfully added. The ddpi_stackstate_fn_add operation returns DW_DLV_ERROR if:

stackstate_fn is NULL
Ddpi_Info associated with stackstate_fn is NULL
identify_handler is NULL
parent_handler is NULL
An error occurs while deallocating memory

Note: ddpi_stackstate_fn_add never returns DW_DLV_NO_ENTRY.