ddpi_stackstate_create operation

The ddpi_stackstate_create operation allocates sufficient contiguous memory for a Ddpi_StackState object, and initializes that object.

Prototype

int ddpi_stackstate_create(
  Ddpi_Info             info,
  Ddpi_StackState*      ret_stackstate,
  Ddpi_Error*           error);

Parameters

info
Input. This accepts the Ddpi_Info object.
ret_stackstate
Output. This returns the Ddpi_StackState.
error
See The libddpi error parameter.

Return values

DW_DLV_OK
Returned when the stack-state object has been successfully initialized.
DW_DLV_NO_ENTRY
Never returned.
DW_DLV_ERROR
This value is returned if:
  • info is NULL
  • ret_stackstate is NULL
  • An error occurs during memory allocation.