次の方法で共有


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

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

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

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

必要条件

要件 価値
ターゲット プラットフォーム 万国
最小 KMDF バージョン 1.29
UMDF の最小バージョン する 2.33
ヘッダー netadapter.h (netadaptercx.h を含む)
IRQL PASSIVE_LEVEL