EVT_NET_ADAPTER_CREATE_RXQUEUE回调函数 (netadapter.h)

  • 项目

客户端驱动程序实现的 EvtNetAdapterCreateRxQueue 事件回调函数，用于设置接收 (Rx) 队列。

语法

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

NTSTATUS EvtNetAdapterCreateRxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETRXQUEUE_INIT *RxQueueInit
)
{...}

参数

[_In_] Adapter

客户端在之前调用 NetAdapterCreate 时创建的网络适配器对象。

[_Inout_] RxQueueInit

指向 NetAdapterCx 分配 的NETRXQUEUE_INIT 结构的指针。 有关详细信息，请参见“备注”部分。

返回值

如果操作成功，则回调函数必须返回STATUS_SUCCESS或NT_SUCCESS (状态) 等于 TRUE 的另一个状态值。 否则，出现相应的 NTSTATUS 错误代码。

注解

若要注册EVT_NET_ADAPTER_CREATE_RXQUEUE回调函数，客户端驱动程序必须调用 NetAdapterCreate。

NETRXQUEUE_INIT 结构是由 NetAdapterCx 定义和分配的不透明结构，类似于 WDFDEVICE_INIT。

在此回调中，客户端驱动程序可能会调用 NetRxQueueInitGetQueueId 来检索要设置的接收队列的标识符。 接下来，客户端调用 NetRxQueueCreate 来分配队列。 如果 NetRxQueueCreate 失败， 则 EvtNetAdapterCreateRxQueue 回调函数应返回错误代码。

NetAdapterCx 在启动序列的末尾调用 EvtNetAdapterCreateRxQueue。

有关实现此回调函数的代码示例，请参阅 传输和接收队列。

要求

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