netadapter.h) (NET_ADAPTER_RX_CAPABILITIES 结构

项目
05/23/2024

NET_ADAPTER_RX_CAPABILITIES结构描述网络适配器的接收功能。

语法

typedef struct _NET_ADAPTER_RX_CAPABILITIES {
  ULONG                                  Size;
  NET_RX_FRAGMENT_BUFFER_ALLOCATION_MODE AllocationMode;
  NET_RX_FRAGMENT_BUFFER_ATTACHMENT_MODE AttachmentMode;
  UINT32                                 FragmentRingNumberOfElementsHint;
  SIZE_T                                 MaximumFrameSize;
  SIZE_T                                 MaximumNumberOfQueues;
  union {
    struct {
      PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer;
    } DUMMYSTRUCTNAME;
    struct {
      NET_MEMORY_MAPPING_REQUIREMENT MappingRequirement;
      SIZE_T                         FragmentBufferAlignment;
      NET_ADAPTER_DMA_CAPABILITIES   *DmaCapabilities;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME;
} NET_ADAPTER_RX_CAPABILITIES;

成员

Size

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

AllocationMode

一个 NET_RX_FRAGMENT_BUFFER_ALLOCATION_MODE 值，该值指定操作系统应如何分配接收缓冲区。

UMDF 驱动程序必须将此值设置为 NetRxFragmentBufferAllocationModeSystem。

AttachmentMode

一个 NET_RX_FRAGMENT_BUFFER_ATTACHMENT_MODE 值，该值指定操作系统应如何预附加接收缓冲区。

UMDF 驱动程序必须将此值设置为 NetRxFragmentBufferAttachmentModeSystem。

FragmentRingNumberOfElementsHint

指示适配器需要为每个接收队列的环形缓冲区 NET_FRAGMENT元素数的提示。此成员必须是 2 的幂。

MaximumFrameSize

适配器可以接收的最大帧大小（以字节为单位）。此值应包括硬件支持的 IP 数据包的最大传输单元 (MTU) 大小，以及驱动程序可能需要用于数据包元数据的额外空间。有关详细信息，请参阅 EVT_PACKET_QUEUE_ADVANCE 的“备注”部分中的接收示例。

MaximumNumberOfQueues

适配器支持的最大接收队列数。

DUMMYUNIONNAME

包含以下成员的联合：

DUMMYUNIONNAME.DUMMYSTRUCTNAME

包含以下成员的结构：

DUMMYUNIONNAME.DUMMYSTRUCTNAME.EvtAdapterReturnRxBuffer

指向驱动程序 EVT_NET_ADAPTER_RETURN_RX_BUFFER 回调函数的指针。如果将 AllocationMode 成员设置为 NetRxFragmentBufferAllocationModeDriver ，则此成员是必需的，以便在系统完成接收缓冲区后调用操作系统。

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

包含以下成员的结构：

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.MappingRequirement

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

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

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.FragmentBufferAlignment

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

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.DmaCapabilities

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

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

注解

调用 NET_ADAPTER_RX_CAPABILITIES_INIT_XXX 函数之一来初始化此结构。有关每个初始化函数的详细信息，请参阅“另请参阅”部分中的链接。初始化 的 NET_ADAPTER_RX_CAPABILITIES 结构作为参数传递给 NetAdapterSetDatapathCapabilities。

通常，客户端驱动程序本身同时执行分配和附加，或者指定操作系统同时执行这两者。在大多数情况下，我们建议操作系统分配并附加接收缓冲区。

如果客户端指定了驱动程序分配的接收缓冲区和附加的接收缓冲区，则它必须在缓冲区分配期间在每个NET_FRAGMENT的 RxBufferReturnContext 成员中提供自定义返回上下文结构，以及在此NET_ADAPTER_RX_CAPABILITIES结构中提供EVT_NET_ADAPTER_RETURN_RX_BUFFER回调函数，以便在使用缓冲区完成后调用操作系统。