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) |