通过

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