次の方法で共有


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