NET_ADAPTER_TX_CAPABILITIES structure

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 NET_ADAPTER_TX_CAPABILITIES structure describes the transmit capabilities of a net adapter.

Syntax

typedef struct _NET_ADAPTER_TX_CAPABILITIES {
  ULONG                          Size;
  NET_MEMORY_MAPPING_REQUIREMENT MappingRequirement;
  SIZE_T                         MaximumFrameSize;
  SIZE_T                         FragmentBufferAlignment;
  SIZE_T                         PayloadBackfill;
  UINT32                         FragmentRingNumberOfElementsHint;
  SIZE_T                         MaximumNumberOfFragments;
  SIZE_T                         MaximumNumberOfQueues;
  NET_ADAPTER_DMA_CAPABILITIES   *DmaCapabilities;
} NET_ADAPTER_TX_CAPABILITIES;

Members

Size

The size of this structure, in bytes.

MappingRequirement

A NET_MEMORY_MAPPING_REQUIREMENT value that specifies how the operating system should map transmit data buffers.

MaximumFrameSize

FragmentBufferAlignment

The minimum alignment for packet fragments. This member must be a power of 2.

PayloadBackfill

The amount of space, in bytes, reserved for the client driver before the start of each NET_PACKET's payload.

FragmentRingNumberOfElementsHint

A hint indicating how many elements the adapter wants for each transmit queue's NET_FRAGMENT ring buffer. This member must be a power of 2.

MaximumNumberOfFragments

The maximum number of fragments per packet that the adapter can handle, or ((SIZE_T) - 1) if there is no limit.

MaximumNumberOfQueues

The maximum number of transmit queues that the adapter supports.

DmaCapabilities

A pointer to a driver-allocated and initialized NET_DMA_CAPABILITIES structure that describes the adapter's DMA capabilities on the transmit path. This member is ignored by NetAdapterCx if MappingRequirement is not set to NetMemoryMappingRequirementDmaMapped.

Remarks

Call one of the NET_ADAPTER_TX_CAPABILITIES_INIT_XXX methods to initialize this structure. For more info about each initialization method, see the links in the See Also section.

An initialized NET_ADAPTER_TX_CAPABILITIES structure is passed as a parameter to NetAdapterSetDatapathCapabilities.

Requirements

   
Minimum KMDF version 1.27
Header netadapter.h (include netadaptercx.h)

See Also

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA