Method FreeChain

src/device/virtio/virt_queue/split.hpp:530–556

* @brief 释放整条描述符链 * * 从链头开始，沿 next 指针遍历并释放所有描述符，直到遇到 * 不含 kDescFNext 标志的描述符为止。 * * 典型用法：在 PopUsed() 获取已完成请求的 head 后， * 用此方法一次性归还整条链的描述符。 * * @param head 描述符链头索引 * @return 成功或失败（如 head 索引无效） * * @warning 非线程安全 * @see virtio-v1.2#2.7.14 Receiving Used Buffers From The Device */

   * @see virtio-v1.2#2.7.14 Receiving Used Buffers From The Device
   */
  auto FreeChain(uint16_t head) -> Expected<void> {
    if (head >= queue_size_) {
      return std::unexpected(Error{ErrorCode::kInvalidDescriptor});
    }

    uint16_t idx = head;
    while (true) {
      if (idx >= queue_size_) {
        return std::unexpected(Error{ErrorCode::kInvalidDescriptor});
      }

      uint16_t next = desc_[idx].next;
      bool has_next =
          (desc_[idx].flags & std::to_underlying(DescFlags::kDescFNext)) != 0;

      desc_[idx].next = free_head_;
      free_head_ = idx;
      ++num_free_;

      if (!has_next) {
        break;
      }
      idx = next;
    }

    return {};
  }

  /**
   * @brief 获取描述符表的物理地址