NetRingGetRangeCount-Funktion (ring.h)

Berechnet die Anzahl der Elemente, die in einem Bereich des angegebenen Netzringpuffers enthalten sind.

Syntax

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

Parameter

[in] Ring

Ein Zeiger auf eine NET_RING.

[in] StartIndex

Der inklusive Anfang des zu messenden Bereichs.

[in] EndIndex

Das exklusive Ende des zu messenden Bereichs.

Rückgabewert

Die Anzahl der Elemente im angegebenen Bereich.

Bemerkungen

Betrachten Sie z. B. einen Netzring mit insgesamt 8 Elementen. Indexwerte für die Elemente sind 0 bis 7. Die Anzahl der Elemente im Bereich [1, 4) ist 3. Dies liegt daran, dass der EndIndex-Wert nicht enthalten ist, sodass der Bereich Elemente zu Indexwerten 1, 2und 3enthält.

Ebenso enthält der Bereich [4, 1) Elemente bei Indexwerten 4, 5, 6, 7und 0 (Schleife bis zum Anfang des Rings) für insgesamt 5 Elemente.

Beachten Sie schließlich, dass ein leerer Bereich wie [2, 2) Nullelemente zurückgibt.

Anforderungen