NetRingCollectionGetFragmentRing 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 NetRingCollectionGetFragmentRing gets the fragment ring for a packet queue.

Syntax

NET_RING * NetRingCollectionGetFragmentRing(
  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 fragment NET_RING for the packet queue.

Remarks

Client drivers typically call this method when they need to work with a fragment ring directly, such as when the driver is posting information to hardware. For example, during transmit a driver might use the fragment ring's ElementIndexMask to retrieve the correct fragment that is being posted to hardware in order to populate the hardware descriptor.

For examples of using this method, see the Realtek sample driver.

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