+ * The number of ranges that were written into this structure
+ * will be placed into its nb_ranges field. This number cannot be
+ * larger than the nb_ranges_alloc that by the user before calling
+ * this function. It can be smaller than the value returned by the
+ * function, however.