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.