alf_task_desc_create

NAME

alf_task_desc_create - Creates a task descriptor.

SYNOPSIS

int alf_task_desc_create (alf_handle_t alf_handle, ALF_ACCEL_TYPE_T accel_type, alf_task_desc_handle_t * p_desc_info_handle);

Parameters  
alf_handle Handle to the ALF runtime.
accel_type [IN] The type of accelerator that tasks created from this descriptor are expected to run on.
p_task_desc_handle [OUT] Returns a handle to the created task description. The content of the pointer is not modified if the call fails.

DESCRIPTION

This function creates a task descriptor. The data structure is returned through the pointer to its handle. The created data structure contains all the information relevant for a compute task.

RETURN VALUE

0 Successful
less than 0 Errors occurred:
  • ALF_ERR_INVAL: Invalid input argument
  • ALF_ERR_BADF: Invalid ALF handle
  • ALF_ERR_NOMEM: Out of memory or system resource
  • ALF_ERR_PERM: The API call is not permitted at the current context
  • ALF_ERR_GENERIC: Generic internal errors
Related reference
alf_task_handle_t
alf_task_desc_handle_t
alf_task_desc_destroy
alf_task_desc_ctx_entry_add
alf_task_desc_set_int32
alf_task_desc_set_int64
alf_task_create
alf_task_finalize
alf_task_wait
alf_task_query
alf_task_destroy
alf_task_depends_on
alf_task_event_handler_register