alf_task_desc_set_int64

NAME

alf_task_desc_set_int64 - Sets the value for a specific long integer field of the task descriptor structure.

SYNOPSIS

int alf_task_desc_set_int64(alf_task_desc_handle_t task_desc_handle, ALF_TASK_DESC_FIELD_T field, unsigned long long value);

Parameters  
task_desc_handle [IN/OUT] Handle to the task descriptor structure
field [IN] The field to be set. Possible inputs are
  • ALF_TASK_DESC_ACCEL_LIBRARY_REF_L: Specify the name of the library that the accelerator image is contained in.
  • ALF_TASK_DESC_ACCEL_IMAGE_REF_L : Specify the name of the accelerator image that is contained in the library.
  • ALF_TASK_DESC_ACCEL_KERNEL_REF_L: Specify the name of the computational kernel function, this usually is a string constant that the accelerator runtime could use to find the correspondent function.
  • ALF_TASK_DESC_ACCEL_INPUT_DTL_REF_L: Specify the name of the input list prepare function, this usually is a string constant that the accelerator runtime could use to find the correspondent function.
  • ALF_TASK_DESC_ACCEL_OUTUT_DTL_REF_L: Specify the name of the output list prepare function, this usually is a string constant that the accelerator runtime could use to find the correspondent function
  • ALF_TASK_DESC_ACCEL_CTX_SETUP_REF_L: Specify the name of the context setup function, this usually is a string constant that the accelerator runtime could use to find the correspondent function.
  • ALF_TASK_DESC_ACCEL_CTX_MERGE_REF_L: Specify the name of the context merge function, this usually a string constant that the accelerator runtime could use to find the correspondent function.
value [IN] New value of the specified field

DESCRIPTION

This function sets the value for a specific long integer field of the task descriptor structure. All string constants must have a maximum number of ALF_STRING_TOKEN_MAX size.

RETURN VALUE

0 Successful
less than 0 Errors occurred:
  • ALF_ERR_INVAL: Invalid input argument
  • ALF_ERR_BADF: Invalid task descriptor handle
  • ALF_ERR_NOSYS: The ALF_TASK_DESC_FIELD provided is not supported.
  • ALF_ERR_PERM: The API call is not permitted at the current context
  • ALF_ERR_RANGE: The specified value is out of the allowed range
  • ALF_ERR_GENERIC: Generic internal errors
Related reference
alf_task_handle_t
alf_task_desc_handle_t
alf_task_desc_create
alf_task_desc_destroy
alf_task_desc_ctx_entry_add
alf_task_desc_set_int32
alf_task_create
alf_task_finalize
alf_task_wait
alf_task_query
alf_task_destroy
alf_task_depends_on
alf_task_event_handler_register