共用方式為

NetTxQueueCreate 函式 （nettxqueue.h）

  • 發行項

建立 net transmit queue 物件。

語法

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

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

傳回值

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

言論

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

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

要求

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