EVT_NET_ADAPTER_CREATE_TXQUEUE回调函数 (netadapter.h)

客户端驱动程序实现 EvtNetAdapterCreateTxQueue 事件回调函数,该函数设置传输 (Tx) 队列。

语法

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

参数

[_In_] Adapter

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

[_Inout_] TxQueueInit

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

返回值

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

注解

若要注册 EVT_NET_ADAPTER_CREATE_TXQUEUE 回调函数,客户端驱动程序必须调用 NetAdapterCreate

NETTXQUEUE_INIT 结构是由 NetAdapterCx 定义和分配的不透明结构,类似于 WDFDEVICE_INIT

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

NetAdapterCx 在启动序列的末尾调用 EvtNetAdapterCreateTxQueue

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

要求

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