EVT_NET_ADAPTER_CREATE_RXQUEUE回呼函式 (netadapter.h)

用戶端驅動程序實作 EvtNetAdapterCreateRxQueue 事件回呼函式，可設定接收 (Rx) 佇列。

語法

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

NTSTATUS EvtNetAdapterCreateRxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETRXQUEUE_INIT *RxQueueInit
)
{...}

參數

[_In_] Adapter

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

[_Inout_] RxQueueInit

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

傳回值

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

備註

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

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

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

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

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

規格需求

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