loopBlockId = NvM_gstaBlockVar[loopBlockId].NxtBlockId; if( TRUE == flag ) { rtrnValu = E_OK; break; } } if( (NVM_BLOCK_HIGHEST_PRI == NvM_gstaBlockVar[BlockId].Priority) && (NVM_WRITE_BLOCK == NvM_Ctrl) ) { Nvm_QueueHeader.CounterImmediate++; } Nvm_QueueHeader.Counter++; } return rtrnValu; }逐句解释代码

这段代码是一个函数，其功能是写入NVM（Non-Volatile Memory，非易失性存储器）块。下面逐句解释代码的作用：

Std_ReturnType NvM_WriteBlock( NvM_BlockIdType BlockId, uint8 *NvM_DstPtr )

定义了一个名为 `NvM_WriteBlock` 的函数，它有两个参数：`BlockId` 表示要写入的NVM块的ID，`NvM_DstPtr` 表示要写入的数据的指针。

{
    Std_ReturnType rtrnValu = E_NOT_OK;
    NvM_RequestResultType flag = NVM_REQ_PENDING;

定义了两个变量：`rtrnValu` 表示函数的返回值，默认为 `E_NOT_OK`；`flag` 表示NVM请求的结果，默认值为 `NVM_REQ_PENDING`。

    if( (BlockId >= NVM_TOTAL_NUMBER_OF_NVRAM_BLOCKS) || (NULL_PTR == NvM_DstPtr) )
    {
        flag = NVM_REQ_NOT_OK;
    }

如果传入的 `BlockId` 大于等于总的NVM块数，或者 `NvM_DstPtr` 是空指针，则将 `flag` 设置为 `NVM_REQ_NOT_OK`。

    else
    {
        uint16 loopBlockId = NvM_BlockDescriptorTable[BlockId].nvBlockNum;

        if( NVM_REQ_PENDING == NvM_AdminBlockTable[BlockId].NvMResult )
        {
            flag = NVM_REQ_PENDING;
        }

否则，将 `loopBlockId` 初始化为 `BlockId` 对应的NVM块的编号，然后判断该块的NVM请求是否还在进行中，如果是，则将 `flag` 设置为 `NVM_REQ_PENDING`。

        else
        {
            flag = NVM_REQ_OK;
        }

        while( NvM_BlockDescriptorTable[loopBlockId].nvBlockNum == loopBlockId )
        {
            if( (NvM_BlockDescriptorTable[loopBlockId].blockDesc & NVM_DCM_BLOCK) == NVM_DCM_BLOCK )
            {
                flag = NVM_REQ_OK;
                break;
            }

如果NVM请求已经完成，将 `flag` 设置为 `NVM_REQ_OK`。然后进入一个while循环，这里的作用是遍历所有的NVM块，找到与 `loopBlockId` 对应的NVM块。在循环中，首先判断当前遍历到的块是否是DCM（Diagnostic Communication Manager）块。如果是，将 `flag` 设置为 `NVM_REQ_OK`，并且跳出循环。

            if( NvM_gstaBlockVar[loopBlockId].NvMResult != NVM_REQ_PENDING )
            {
                if( (NvM_BlockDescriptorTable[loopBlockId].blockDesc & NVM_SELECT_BLOCK_FOR_READ_ALL) == NVM_SELECT_BLOCK_FOR_READ_ALL )
                {
                    NvM_ReadAllFlag = TRUE;
                }

                NvM_gstaBlockVar[loopBlockId].NvMResult = NVM_REQ_PENDING;
                NvM_gstaBlockVar[loopBlockId].NvMCurrentJob = NVM_WRITE_BLOCK;
                NvM_gstaBlockVar[loopBlockId].NvMDstPtr = NvM_DstPtr;
                NvM_gstaBlockVar[loopBlockId].NvMJobPriority = NvM_BlockDescriptorTable[loopBlockId].blockJobPriority;
                NvM_gstaBlockVar[loopBlockId].NvMNumOfBytes = NvM_BlockDescriptorTable[loopBlockId].blockLength;
                NvM_gstaBlockVar[loopBlockId].NxtBlockId = NvM_BlockDescriptorTable[loopBlockId].nvBlockNum;

                flag = NVM_REQ_OK;
            }

            loopBlockId = NvM_gstaBlockVar[loopBlockId].NxtBlockId;

            if( TRUE == flag )
            {
                rtrnValu = E_OK;
                break;
            }
        }

如果当前遍历到的NVM块的请求已经完成，那么将该块的请求状态设置为 `NVM_REQ_PENDING`，并且设置其它属性，如目标指针、操作类型、优先级、字节数等。然后将 `flag` 设置为 `NVM_REQ_OK`。然后通过 `NvM_gstaBlockVar[loopBlockId].NxtBlockId` 找到下一个需要遍历的块。最后判断 `flag` 是否为真，如果是，则将 `rtrnValu` 设置为 `E_OK`，并且跳出循环。

        if( (NVM_BLOCK_HIGHEST_PRI == NvM_gstaBlockVar[BlockId].Priority) && (NVM_WRITE_BLOCK == NvM_Ctrl) )
        {
            Nvm_QueueHeader.CounterImmediate++;
        }

        Nvm_QueueHeader.Counter++;
    }

    return rtrnValu;
}

如果当前遍历的NVM块是最高优先级的块，并且操作类型是写入，则将 `Nvm_QueueHeader.CounterImmediate` 加1。无论如何，将 `Nvm_QueueHeader.Counter` 加1。最后返回 `rtrnValu`。