Function esp_idf_hal::sys::xRingbufferReceive
source ยท pub unsafe extern "C" fn xRingbufferReceive(
xRingbuffer: *mut c_void,
pxItemSize: *mut usize,
xTicksToWait: u32,
) -> *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.