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（status） 等於 TRUE 的另一個狀態值。 否則，適當的 NTSTATUS 錯誤碼。

言論

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

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

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

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

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

要求

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