NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED 函数 (netadapter.h)

  • 项目

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED 函数为要指定驱动程序管理的接收缓冲区分配和附件的 net 适配器初始化NET_ADAPTER_RX_CAPABILITIES结构。

语法

void NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES      *RxCapabilities,
  [_In_]  PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer,
  [_In_]  SIZE_T                           MaximumFrameSize,
  [_In_]  SIZE_T                           MaximumNumberOfQueues
);

参数

[_Out_] RxCapabilities

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

[_In_] EvtAdapterReturnRxBuffer

指向客户端驱动程序的 EVT_NET_ADAPTER_RETURN_RX_BUFFER 回调函数的指针。 有关详细信息，请参见“备注”部分。

[_In_] MaximumFrameSize

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

[_In_] MaximumNumberOfQueues

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

返回值

无

备注

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

如果客户端驱动程序要执行手动接收缓冲区分配和附件，则必须调用 NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED 来初始化其 NET_ADAPTER_RX_CAPABILITIES 结构。 通过调用此函数，Rx 功能结构的 AllocationMode 成员设置为 NetRxFragmentBufferAllocationModeDriver，AttachmentMode 成员设置为 NetRxFragmentBufferAttachmentModeDriver。 在这种情况下，它还必须在结构中提供指向其 EVT_NET_ADAPTER_RETURN_RX_BUFFER 回调函数的指针，以便在系统完成接收缓冲区后调用操作系统。

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.25
标头 netadapter.h (包括 netadaptercx.h)
IRQL PASSIVE_LEVEL

另请参阅

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA