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

言論

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

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

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

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

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

要求

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