EVT_NET_ADAPTER_CREATE_TXQUEUE回呼函式 (netadapter.h)

用戶端驅動程序實作 EvtNetAdapterCreateTxQueue 事件回呼函式，可設定傳輸 (Tx) 佇列。

語法

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

參數

[_In_] Adapter

用戶端在呼叫 NetAdapterCreate 之前建立的網路適配器物件。

[_Inout_] TxQueueInit

NetAdapterCx 配置 NETTXQUEUE_INIT 結構的指標。 如需詳細資訊，請參閱＜備註＞一節。

傳回值

如果作業成功，回呼函式必須傳回STATUS_SUCCESS，或NT_SUCCESS (状态) 等於 TRUE 的另一個狀態值。 否則，適當的 NTSTATUS 錯誤碼。

備註

若要註冊 EVT_NET_ADAPTER_CREATE_TXQUEUE 回呼函式，用戶端驅動程序必須呼叫 NetAdapterCreate。

NETTXQUEUE_INIT 結構是 NetAdapterCx 所定義和配置的不透明結構，類似於WDFDEVICE_INIT。

在此回呼中，客戶端驅動程式可能會呼叫 NetTxQueueInitGetQueueId 來擷取要設定之傳輸佇列的標識碼。 接下來，用戶端會呼叫 NetTxQueueCreate 來配置佇列。 如果 NetTxQueueCreate 失敗， EvtNetAdapterCreateTxQueue 回呼函式應該會傳回錯誤碼。

NetAdapterCx 會在電源序列結尾呼叫 EvtNetAdapterCreateTxQueue。

如需實作此回呼函式的程式碼範例，請參閱 傳輸和接收佇列。

規格需求

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