次の方法で共有


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

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

構文

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

パラメーター

[_In_] Adapter

NetAdapterCreate の以前の呼び出しでクライアントが作成したネットワーク アダプター オブジェクト。

[_Inout_] TxQueueInit

NetAdapterCx によって割り当てられた NETTXQUEUE_INIT 構造体へのポインター。 詳細については、「解説」を参照してください。

戻り値

操作が成功した場合、コールバック関数は STATUS_SUCCESS、または NT_SUCCESS(status) が TRUE に等しい別の状態値を返す必要があります。 それ以外の場合は、適切な NTSTATUS エラー コード。

注釈

EVT_NET_ADAPTER_CREATE_TXQUEUEコールバック関数を登録するには、クライアント ドライバーで NetAdapterCreate を呼び出す必要があります。

NETTXQUEUE_INIT構造体は、WDFDEVICE_INITと同様に NetAdapterCx によって定義および割り当てられる不透明な構造体です。

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

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

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

要件

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