FreeRTOS内存释放函数vPortFree源码分析（10.5.1版本）

void vPortFree( void * pv )
{
    uint8_t * puc = ( uint8_t * ) pv;
    BlockLink_t * pxLink;

    if( pv != NULL )
    {
        /* The memory being freed will have an BlockLink_t structure immediately
         * before it. */
        /* 指针移到结构体头，连结构体一起释放 */
        puc -= xHeapStructSize;

        /* This casting is to keep the compiler from issuing warnings. */
        pxLink = ( void * ) puc;

        /* 判断该内存块是否被使用 */
        configASSERT( heapBLOCK_IS_ALLOCATED( pxLink ) != 0 );
        configASSERT( pxLink->pxNextFreeBlock == NULL );

        if( heapBLOCK_IS_ALLOCATED( pxLink ) != 0 )/* 被使用 */
        {
            if( pxLink->pxNextFreeBlock == NULL )/* 不在空闲列表内 */
            {
                /* The block is being returned to the heap - it is no longer
                 * allocated. */
                /* 标记内存块为未使用 */
                heapFREE_BLOCK( pxLink );
                #if ( configHEAP_CLEAR_MEMORY_ON_FREE == 1 )
                {
                    ( void ) memset( puc + xHeapStructSize, 0, pxLink->xBlockSize - xHeapStructSize );
                }
                #endif

                vTaskSuspendAll();
                {
                    /* Add this block to the list of free blocks. */
                    /* 更新当前空闲内存大小 */
                    xFreeBytesRemaining += pxLink->xBlockSize;


                    traceFREE( pv, pxLink->xBlockSize );

                    /* 插回空闲列表 */
                    prvInsertBlockIntoFreeList( ( ( BlockLink_t * ) pxLink ) );
                    
                    /* 累加成功次数 */
                    xNumberOfSuccessfulFrees++;
                }
                ( void ) xTaskResumeAll();
            }
            else
            {
                mtCOVERAGE_TEST_MARKER();
            }
        }
        else
        {
            mtCOVERAGE_TEST_MARKER();
        }
    }
}