Funzione NetRingGetRangeCount (ring.h)

Articolo
02/07/2025

Calcola il numero di elementi contenuti in un intervallo del buffer circolare netto specificato.

Sintassi

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

Parametri

[in] Ring

Puntatore a un NET_RING.

[in] StartIndex

Inizio inclusivo dell'intervallo da misurare.

[in] EndIndex

Fine esclusiva dell'intervallo da misurare.

Valore restituito

Numero di elementi nell'intervallo specificato.

Osservazioni

Si consideri, ad esempio, un anello netto contenente un totale di 8 elementi. I valori di indice per gli elementi sono 0 fino a 7. Il numero di elementi nell'intervallo [1, 4) è 3. Ciò avviene perché il valore di EndIndex non è incluso, pertanto l'intervallo include elementi in corrispondenza dei valori di indice 1, 2e 3.

Analogamente, l'intervallo [4, 1) include elementi in corrispondenza dei valori di indice 4, 5, 6, 7e 0 (ciclo all'inizio dell'anello), per un totale di 5 elementi.

Si noti infine che un intervallo vuoto come [2, 2) restituisce zero elementi.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.29
versione minima di UMDF	2.33
intestazione	ring.h (include netadaptercx.h)
IRQL	Qualsiasi livello purché la memoria di destinazione sia residente

Condividi tramite