dcrp_rcv_unsolicited_data_stamp

Processes the received unsolicited data.

Syntax

int dcrp_rcv_unsolicited_data_stamp(device_id, addr_data,
        sizeof_data, data_buffer, pStamp, status)
char *device_id;
ADDR_DATA *addr_data;
int sizeof_data
char *data_buffer;
COR_STAMP *pStamp
int *status;

Input Parameters

device_id

Is the Device ID for the device originating the unsolicited data.

addr_data

Is a pointer to the address from which the data was read. ADDR_DATA is a typedef to a structure defined in < inc_path/toolkit.h > .

sizeof_data

Is the number of bytes of data being received.

data_buffer

Is the pointer to the buffer containing the unsolicited data.

  • For data from bit (TOOLKIT_BIT) domains, bit data should be packed into bytes so that the leftmost bit is the most significant.
  • For domains whose element size is greater than one byte, the bytes should be ordered in the same way as ordered by the underlying operating system on which the enabler is to run.

The caller is responsible for managing the data buffer (this might include allocating and deallocating the space or using a static data structure to maintain the data).

The data buffer should not exceed TOOLKIT_MAX_INTERNAL_BUFFER bytes.

pStamp

Is a pointer to the structure defining the timestamp to be used to record the time at which the data is reported. COR_STAMP is a typedef to a structure defined in <inc_path/cor.h> .

Output Parameters

status

Is the function completion status. Valid values are:

TOOLKIT_SUCCESS Function completed successfully. 
TOOLKIT_FAILURE Function not completed.
Return Value

This subroutine returns one of the following:

TOOLKIT_SUCCESS Function completed successfully. 
TOOLKIT_FAILURE Function not completed successfully.