通过

NetRxQueueCreate 函数 （netrxqueue.h）

  • 项目

创建一个净接收队列对象。

语法

NTSTATUS NetRxQueueCreate(
  [_Inout_]  NETRXQUEUE_INIT         *NetRxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *RxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

参数

[_Inout_] NetRxQueueInit

指向客户端驱动程序在其 EVT_NET_ADAPTER_CREATE_RXQUEUE 回调函数中接收的NETRXQUEUE_INIT结构的指针。

[_In_opt_] RxQueueAttributes

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

[_In_] Configuration

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

[_Out_] PacketQueue

指向接收新 net 接收队列对象的句柄的位置的指针。

返回值

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

言论

客户端从其 EVT_NET_ADAPTER_CREATE_RXQUEUE 事件回调函数中调用 NetRxQueueCreate。 有关将上下文空间分配给新对象的信息，请参阅 框架对象上下文空间。

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

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.27
最低 UMDF 版本 2.33
标头 netrxqueue.h （包括 netadaptercx.h）
库 NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL