NetRingCollectionGetPacketRing function (ringcollection.h)

The NetRingCollectionGetPacketRing gets the packet ring for a packet queue.

Syntax

NET_RING * NetRingCollectionGetPacketRing(
  NET_RING_COLLECTION const *Rings
);

Parameters

Rings

A pointer to a NET_RING_COLLECTION structure that describes this packet queue's net rings.

Return value

Returns a pointer to the packet NET_RING for the packet queue.

Remarks

Client drivers typically call this function when they need information about a packet ring, such as the number of elements in the ring. For example, during its queue initialization routines a client driver might need to allocate memory for hardware descriptors in a one-to-one ratio to the number of packets in the packet ring.

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.29
Header ringcollection.h (include netadaptercx.h)
IRQL Any level as long as target memory is resident

See also

Introduction to net rings