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. |
Device Communications Toolkit other subroutines. |