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

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

構文

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
ヘッダー netadapter.h (netadaptercx.h を含む)
IRQL PASSIVE_LEVEL