NetRxQueueCreate 函式 (netrxqueue.h)

  • 發行項

建立 net receive queue 物件。

語法

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。 如需將內容空間指派給新物件的詳細資訊，請參閱 Framework 對象內容空間。

NETPACKETQUEUE 對像是標準 WDF 物件。 架構會管理其刪除，這會在刪除父 NETADAPTER 物件時發生。

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.27
標頭 netrxqueue.h (包含 netadaptercx.h)
程式庫 NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL