heap_trace_get() function

- ESP_ERR_NOT_SUPPORTED Project was compiled without heap tracing enabled in menuconfig. - ESP_ERR_INVALID_STATE Heap tracing was not initialised. - ESP_ERR_INVALID_ARG Index is out of bounds for current heap trace record count. - ESP_OK Record returned successfully.

It is safe to call this function while heap tracing is running, however in HEAP_TRACE_LEAK mode record indexing may skip entries unless heap tracing is stopped first.