NetRingCollectionGetPacketRing function

Warning

Some information in this topic relates to prereleased product, which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

NetAdapterCx is preview only in Windows 10, version 1903.

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 method 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

   
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

Net rings and net ring iterators