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

規格需求

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