Method AllocDesc

src/device/virtio/virt_queue/split.hpp:298–308

* @brief 从空闲链表分配一个描述符 * * 从空闲描述符链表中取出一个描述符，供上层使用。 * 调用者必须填充描述符的 addr、len、flags 和 next 字段。 * * @return 成功返回描述符索引（range: 0 ~ queue_size-1）； * 空闲链表为空时返回 ErrorCode::kNoFreeDescriptors * * @warning 非线程安全：多个线程同时调用可能导致竞态条件 * @see virtio-v1.2#2.7.5 The Virtqueue Descriptor Table * @see virtio-v1.2#2.7.13 Supplying Buffers to The Device */

   * @see virtio-v1.2#2.7.13 Supplying Buffers to The Device
   */
  [[nodiscard]] auto AllocDesc() -> Expected<uint16_t> {
    if (num_free_ == 0) {
      return std::unexpected(Error{ErrorCode::kNoFreeDescriptors});
    }

    uint16_t idx = free_head_;
    free_head_ = desc_[free_head_].next;
    --num_free_;

    return idx;
  }

  /**
   * @brief 归还描述符到空闲链表