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 |