通过

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（status） 等于 TRUE 的另一个状态值。 否则，NTSTATUS 错误代码。

言论

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

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

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

NetAdapterCx 调用 EvtNetAdapterCreateRxQueue电源序列的末尾。

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

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.29
最低 UMDF 版本 2.33
标头 netadapter.h （包括 netadaptercx.h）
IRQL PASSIVE_LEVEL