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 |
| Minimum UMDF version | 2.33 |
| Header | ringcollection.h (include netadaptercx.h) |
| IRQL | Any level as long as target memory is resident |