Функция NetRingGetRangeCount (ring.h)

Статья
02/07/2025

Вычисляет количество элементов, содержащихся в диапазоне указанного чистого кольцевого буфера.

Синтаксис

UINT32 NetRingGetRangeCount(
  [in] NET_RING const *Ring,
  [in] UINT32         StartIndex,
  [in] UINT32         EndIndex
);

Параметры

[in] Ring

Указатель на NET_RING.

[in] StartIndex

Инклюзивное начало диапазона для измерения.

[in] EndIndex

Эксклюзивный конец диапазона для измерения.

Возвращаемое значение

Количество элементов в заданном диапазоне.

Замечания

Например, рассмотрим сетевое кольцо, содержащее в общей сложности 8 элементов. Значения индекса для элементов 0 до 7. Число элементов в диапазоне [1, 4) равно 3. Это связано с тем, что значение EndIndex не включается, поэтому диапазон включает элементы со значениями индекса 1, 2и 3.

Аналогичным образом диапазон [4, 1) включает элементы с значениями индекса 4, 5, 6, 7и 0 (цикл обратно к началу кольца) для всего 5 элементов.

Наконец, обратите внимание, что пустой диапазон, например [2, 2) возвращает нулевые элементы.

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.29
минимальная версия UMDF	2.33
заголовка	ring.h (include netadaptercx.h)
IRQL	Любой уровень, если целевая память является резидентной

Поделиться через