netadapter.h) (NET_ADAPTER_TX_CAPABILITIES 结构

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 值，该值指定操作系统应如何映射传输数据缓冲区。

UMDF 驱动程序必须将 MappingRequirement 设置为 NetMemoryMappingRequirementNone。

PayloadBackfill

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

MaximumNumberOfFragments

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

FragmentBufferAlignment

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

FragmentRingNumberOfElementsHint

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

MaximumNumberOfQueues

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

DmaCapabilities

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

UMDF NetAdapterCX 不支持 DmaCapabilities。 UMDF 驱动程序必须将此成员设置为 NULL。

注解

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

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

要求

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

另请参阅

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA