NetTxQueueCreate 函数 (nettxqueue.h)

创建网络传输队列对象。

语法

NTSTATUS NetTxQueueCreate(
  [_Inout_]  NETTXQUEUE_INIT         *NetTxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *TxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

参数

[_Inout_] NetTxQueueInit

指向客户端驱动程序在 EVT_NET_ADAPTER_CREATE_TXQUEUE 中收到的 NETTXQUEUE_INIT结构的指针。

[_In_opt_] TxQueueAttributes

指向已初始化的调用方分配 WDF_OBJECT_ATTRIBUTES 结构的指针。 此参数是可选的,可以 WDF_NO_OBJECT_ATTRIBUTES。 但是,如果客户端驱动程序提供此参数, 则 ParentObject 字段必须为 NULL

[_In_] Configuration

指向调用方分配 的NET_PACKET_QUEUE_CONFIG 结构的指针。

[_Out_] PacketQueue

指向接收新网络传输队列对象的句柄的位置的指针。

返回值

如果操作成功,函数将返回STATUS_SUCCESS。 否则,此函数可能会返回相应的 NTSTATUS 错误代码。

注解

客户端从其EVT_NET_ADAPTER_CREATE_TXQUEUE事件回调函数中调用 NetTxQueueCreate。 有关为新对象分配上下文空间的信息,请参阅 框架对象上下文空间

NETPACKETQUEUE 对象是标准 WDF 对象。 框架管理其删除,这在删除父 NETADAPTER 对象时发生。

要求

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