dcrp_rcv_unsolicited_data
Processes the received unsolicited data.
Syntax
int dcrp_rcv_unsolicited_data(char *device_id,
ADDR_DATA *addr_data,
int sizeof_data,
char *data_buffer,
int *status)
Input Parameters
device_id
Contains 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 left most 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 de-allocating the space or using a static data structure to maintain the data).
The data buffer should not exceed TOOLKIT_MAX_INTERNAL_BUFFER
bytes.
Output Parameters
status
Contains 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. |