Method CalcSize

src/device/virtio/virt_queue/split.hpp:203–228

* @brief 计算给定队列大小所需的 DMA 内存字节数 * * @param queue_size 队列大小（必须为 2 的幂） * @param event_idx 是否启用 VIRTIO_F_EVENT_IDX 特性 * @param used_align Used Ring 的对齐要求 * @return 所需的 DMA 内存字节数 * @see virtio-v1.2#2.6 Split Virtqueues */

   * @see virtio-v1.2#2.6 Split Virtqueues
   */
  [[nodiscard]] static constexpr auto CalcSize(uint16_t queue_size,
                                               bool event_idx = true,
                                               size_t used_align = Used::kAlign)
      -> size_t {
    // Descriptor Table: sizeof(Desc) * queue_size
    size_t desc_total = static_cast<size_t>(sizeof(Desc)) * queue_size;

    // Available Ring: flags(2) + idx(2) + ring[N](2*N) + used_event(2, 可选)
    size_t avail_total = sizeof(uint16_t) * (2 + queue_size);
    if (event_idx) {
      avail_total += sizeof(uint16_t);
    }

    // Used Ring: flags(2) + idx(2) + ring[N](sizeof(UsedElem)*N) +
    // avail_event(2, 可选)
    size_t used_total = sizeof(uint16_t) * 2 + sizeof(UsedElem) * queue_size;
    if (event_idx) {
      used_total += sizeof(uint16_t);
    }

    // 按对齐要求排列
    size_t avail_off = AlignUp(desc_total, Avail::kAlign);
    size_t used_off = AlignUp(avail_off + avail_total, used_align);

    return used_off + used_total;
  }

  /**
   * @brief 从预分配的 DMA 缓冲区构造 SplitVirtqueue