EVT_PACKET_QUEUE_STOP コールバック関数 (netpacketqueue.h)

EvtPacketQueueStop コールバック関数は、パケット キューのデータ パスを停止するためにクライアント ドライバーによって実装される省略可能なコールバックです。

構文

EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;

void EvtPacketQueueStop(
  [_In_] NETPACKETQUEUE PacketQueue
)
{...}

パラメーター

[_In_] PacketQueue

パケット キューへのハンドル。

戻り値

なし

解説

これは省略可能なコールバックです。 このコールバック関数を 、EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE コールバックに 登録します。 NET_PACKET_QUEUE_CONFIG_INITを使用して構造体を初期化した後、NET_PACKET_QUEUE_CONFIG構造体の適切なメンバーを設定し、NetTx(rxQueueContext)QueueCreate を呼び出します。

このコールバックは値を返さないため、失敗しないようにしてください。そのため、このコールバックは、迅速に実行される軽量の関数である必要があります。

クライアント ドライバーは、EvtPacketQueueStop が戻った後、EVT_PACKET_QUEUE_ADVANCEEVT_PACKET_QUEUE_CANCEL、またはEVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLEDへの呼び出しを受け取りません。 さらに、EvtPacketQueueStop は、EvtPacketQueueAdvance、EvtPacketQueueCancelEvtPacketQueueSetNotificationEnabled と同じ実行コンテキストまたはスレッドで呼び出されるため、クライアント ドライバーは個々のキュー インスタンスに対してこれらのコールバック関数間で同期する必要はありません。

NetAdapterCx データ パス ポーリング モデルを示す詳細と図については、「キューの 送受信」を参照してください。

要件

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

こちらもご覧ください

EVT_NET_ADAPTER_CREATE_RXQUEUE

EVT_NET_ADAPTER_CREATE_TXQUEUE

NetRxQueueCreate

NetTxQueueCreate

EVT_PACKET_QUEUE_START

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED

EVT_PACKET_QUEUE_CANCEL