ddpi_process_create operation

The ddpi_process_create operation creates a Ddpi_Process object to represent a process and returns a descriptor that represents a handle for accessing a process.

Description

When you call the operation, and pass a character string as the parameter name, the operation copies the contents of name. After the operation returns, you can deallocate the original name to re-use the storage.

Prototype

int ddpi_process_create(              
  Ddpi_Space            space,        
  char*                 name,         
  Ddpi_Process_Type     type,         
  Ddpi_PRID             id,           
  int                   user_area_len,
  Ddpi_Process*         ret_process,  
  Ddpi_Error*           error);

Parameters

space: Input. This accepts the Ddpi_Space object that represents the address space of the owner of this process.
name: Input. This accepts a process name.
type: Input. This accepts a process type.
id: Input. This accepts a process ID.
user_area_len: Input. This accepts the user-area length.
ret_process: Output. This returns the process object.
error: See The libddpi error parameter.

Return values

DW_DLV_OK

Returned upon successful retrieval of the process descriptor.

DW_DLV_NO_ENTRY

Never returned.

DW_DLV_ERROR

Returned if:

space is NULL
Ddpi_Info associated with space is NULL
ret_process is NULL
user_area_len is less than zero
An error occurs while allocating memory