Event decoding dispatcher.
The event decoding dispatcher will route the event packet to the correct decoder, which in turn decodes the contents of the event and updates the p_event
struct.
If p_event
is null, the required length of p_event
is returned in p_event_len
.
- Parameters
-
[in] | p_buf | Pointer to the beginning of the event packet. |
[in] | packet_len | Length (in bytes) of the event packet. |
[in,out] | p_event | Pointer to the ant_evt_t buffer where the decoded event will be stored. If NULL, the required length will be returned in p_event_len . |
[in,out] | p_event_len | in: Size (in bytes) of p_event buffer. out: Length of the decoded contents of p_event . |
- Return values
-
NRF_SUCCESS | Decoding success. |
NRF_ERROR_NULL | Decoding failure. NULL pointer supplied. |
NRF_ERROR_INVALID_LENGTH | Decoding failure. Incorrect buffer length. |
NRF_ERROR_DATA_SIZE | Decoding failure. Length of p_event is too small to hold the decoded event. |
NRF_ERROR_NOT_FOUND | Decoding failure. No event decoder is available. |