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

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

返回值

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

注解

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

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

要求

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