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

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

PayloadBackfill

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

MaximumNumberOfFragments

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

FragmentBufferAlignment

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

FragmentRingNumberOfElementsHint

一个提示，指示适配器希望为每个传输队列的 NET_FRAGMENT 环缓冲区使用多少个元素。 此成员必须是 2 的幂。

MaximumNumberOfQueues

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

DmaCapabilities

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

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

言论

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

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

要求

另请参阅

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA