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
标头 netadapter.h (包括 netadaptercx.h)
IRQL PASSIVE_LEVEL