Function esp_idf_sys::xRingbufferReceive

source ยท
pub unsafe extern "C" fn xRingbufferReceive(
    xRingbuffer: RingbufHandle_t,
    pxItemSize: *mut usize,
    xTicksToWait: TickType_t,
) -> *mut c_void
Expand description

@brief Retrieve an item from the ring buffer

Attempt to retrieve an item from the ring buffer. This function will block until an item is available or until it times out.

@param[in] xRingbuffer Ring buffer to retrieve the item from @param[out] pxItemSize Pointer to a variable to which the size of the retrieved item will be written. @param[in] xTicksToWait Ticks to wait for items in the ring buffer.

@note A call to vRingbufferReturnItem() is required after this to free the item retrieved. @note It is possible to receive items with a pxItemSize of 0 on no-split/allow split buffers.

@return - Pointer to the retrieved item on success; *pxItemSize filled with the length of the item. - NULL on timeout, *pxItemSize is untouched in that case.