通过

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（status） 等于 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