NET_ADAPTER_TX_CAPABILITIES 结构 (netadapter.h)

NET_ADAPTER_TX_CAPABILITIES结构描述了网络适配器的传输功能。

语法

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

成员

Size

此结构的大小（以字节为单位）。

MappingRequirement

一个NET_MEMORY_MAPPING_REQUIREMENT值，该值指定操作系统应如何映射传输数据缓冲区。

PayloadBackfill

在每个NET_PACKET有效负载开始之前为客户端驱动程序保留的空间量 （以字节为单位）。

MaximumNumberOfFragments

适配器可以处理的每个数据包的最大片段数;如果没有限制， ((SIZE_T) - 1) 则为 。

FragmentBufferAlignment

数据包片段的最小对齐方式。 此成员必须是 2 的幂。

FragmentRingNumberOfElementsHint

指示适配器需要用于每个传输队列 NET_FRAGMENT 环缓冲区的元素数的提示。 此成员必须是 2 的幂。

MaximumNumberOfQueues

适配器支持的最大传输队列数。

DmaCapabilities

指向驱动程序分配和初始化 的NET_DMA_CAPABILITIES 结构的指针，该结构描述适配器在传输路径上的 DMA 功能。 如果 MappingRequirement 未设置为 NetMemoryMappingRequirementDmamapped，NetAdapterCx 将忽略此成员。

注解

调用 NET_ADAPTER_TX_CAPABILITIES_INIT_XXX 函数之一来初始化此结构。 有关每个初始化函数的详细信息，请参阅另请参阅部分中的链接。

初始化 NET_ADAPTER_TX_CAPABILITIES 结构作为参数传递给 NetAdapterSetDatapathCapabilities。

要求

要求	值
最低 KMDF 版本	1.27
标头	netadapter.h (包括 netadaptercx.h)

另请参阅

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA