共用方式為

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 物件時發生。

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.27
最低 UMDF 版本 2.33
標頭 netrxqueue.h （包括 netadaptercx.h）
連結庫 NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL