NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED函数 (netadapter.h)

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED 函数初始化要指定作系统管理的接收缓冲区分配和附件的 net 适配器的 NET_ADAPTER_RX_CAPABILITIES 结构,但不能使用 DMA 内存映射。

语法

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_In_]  SIZE_T                      MaximumFrameSize,
  [_In_]  SIZE_T                      MaximumNumberOfQueues
);

参数

[_Out_] RxCapabilities

指向驱动程序分配 NET_ADAPTER_RX_CAPABILITIES 结构的指针。

[_In_] MaximumFrameSize

适配器可以接收的最大帧大小(以字节为单位)。

[_In_] MaximumNumberOfQueues

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

返回值

没有

言论

此函数是三个可能的函数之一,用于初始化 NET_ADAPTER_RX_CAPABILITIES 结构。 客户端驱动程序应调用哪个客户端驱动程序取决于其分配接收缓冲区的方式以及是否要使用 DMA。

如果客户端驱动程序希望作系统执行接收缓冲区分配和附件,但不需要 DMA 内存映射,则客户端驱动程序必须调用 NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED 来初始化其 NET_ADAPTER_RX_CAPABILITIES 结构。 通过调用此函数,Rx 功能结构的 AllocationMode 成员设置为 NetRxFragmentBufferAllocationModeSystemAttachmentMode 成员设置为 NetRxFragmentBufferAttachmentModeSystem。 由于驱动程序在此示例中未指定 DMA 功能,因此此函数还将 MappingRequirement 成员设置为 NetMemoryMappingRequirementNone

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.25
最低 UMDF 版本 2.33
标头 netadapter.h (包括 netadaptercx.h)

另请参阅

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA