NetRingGetRangeCount 関数 (ring.h)

指定したネットリングバッファーの範囲に含まれる要素の数を計算します。

構文

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) のような空の範囲は 0 個の要素を返します。