EVT_NET_ADAPTER_CREATE_RXQUEUE コールバック関数 (netadapter.h)

  • [アーティクル]

受信 (Rx) キューを設定する EvtNetAdapterCreateRxQueue イベント コールバック関数のクライアント ドライバーの実装。

構文

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構造体は、WDFDEVICE_INITと同様に NetAdapterCx によって定義および割り当てられる不透明な構造体です。

このコールバックでは、クライアント ドライバーが NetRxQueueInitGetQueueId を 呼び出して、設定する受信キューの識別子を取得する場合があります。 次に、クライアントは NetRxQueueCreate を 呼び出してキューを割り当てます。 NetRxQueueCreate が失敗した場合、EvtNetAdapterCreateRxQueue コールバック関数はエラー コードを返す必要があります。

NetAdapterCx は、電源投入シーケンスの最後で EvtNetAdapterCreateRxQueue を呼び出します。

このコールバック関数を実装するコード例については、「 キューの送受信」を参照してください。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.29
Header netadapter.h (netadaptercx.h を含む)
IRQL PASSIVE_LEVEL