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 成员设置为 NetRxFragmentBufferAllocationModeDriverAttachmentMode 成员设置为 NetRxFragmentBufferAttachmentModeDriver。 在这种情况下,它还必须提供指向其 EVT_NET_ADAPTER_RETURN_RX_BUFFER 回调函数的指针,以便作系统在系统完成接收缓冲区后调用。

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.25
最低 UMDF 版本 2.33
标头 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