netadapter.) h (EVT_NET_ADAPTER_CREATE_TXQUEUE回调函数

客户端驱动程序的 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 调用 Power-up 序列末尾的 EvtNetAdapterCreateTxQueue

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

要求

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