共用方式為

NetTxQueueCreate 函式 (nettxqueue.h)

  • 發行項

建立 net 傳輸佇列物件。

語法

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

接收新 Net 傳輸佇列物件句柄的位置指標。

傳回值

如果作業成功，函式會傳回STATUS_SUCCESS。 否則，此函式可能會傳回適當的NTSTATUS錯誤碼。

備註

用戶端會從其EVT_NET_ADAPTER_CREATE_TXQUEUE事件回呼函式內呼叫 NetTxQueueCreate。 如需將內容空間指派給新物件的詳細資訊，請參閱 Framework 對象內容空間。

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

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.27
最低UMDF版本 2.33
標頭 nettxqueue.h (包括 netadaptercx.h)
IRQL PASSIVE_LEVEL