次の方法で共有


NDIS_WDI_TX_DEQUEUE_INDコールバック関数 (dot11wdi.h)

重要

このトピックは、Windows 10でリリースされた WDI ドライバー モデルの一部です。 WDI ドライバー モデルはメンテナンス モードであり、優先度の高い修正プログラムのみを受け取ります。 WiFiCx は、Windows 11でリリースされた Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。

NdisWdiTxDequeueIndication コールバック関数は、WDI から IHV ミニポートにフレームをデキューするために、IHV ミニポートによって MiniportWdiTxDataSend または MiniportWdiTxTalSend のコンテキストで呼び出されます。

これは、 NDIS_WDI_DATA_API内のコールバックです。

構文

NDIS_WDI_TX_DEQUEUE_IND NdisWdiTxDequeueInd;

void NdisWdiTxDequeueInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  UINT32 Quantum,
  [in]  UINT8 MaxNumFrames,
  [in]  UINT16 Credit,
  [out] PNET_BUFFER_LIST *ppNBL
)
{...}

パラメーター

[in] NdisMiniportDataPathHandle

NdisMiniportDataPathHandle は、MiniportWdiTalTxRxInitialize の IHV ミニポートに渡されます。

[in] Quantum

量子。 詳細については、「WDI TX パス」の「ホスト - ターゲット TX 転送スケジューリング」セクションを参照してください。

[in] MaxNumFrames

最大フレーム数。

[in] Credit

クレジット値。 詳細については、WDI TX パスのターゲット クレジット スキームと一時停止/再開メカニズムに関するセクションを参照してください。

[out] ppNBL

WDI によってデキューされた NET_BUFFER_LIST チェーンへのポインターへのポインター。

戻り値

なし

解説

パラメーターのサブセットは、デバイスに適用できない場合があります。 たとえば、最大フレーム数は、ストアおよび転送デバイス (メッセージ ベースのバス インターフェイス) には適用されない場合があります。

このような状況では、TxMgr では次のパラメーターは無視されます。

  • WDI_TX_QUANTUM_INVALID に設定されている場合の Quantum (0xFFFFFFFF)
  • MaxNumFramesWDI_TX_MAX_FRAME_COUNT_INVALID に設定した場合 (0xFF)
  • WDI_TX_CREDIT_INVALID に設定 されている場合の クレジット (0xFFFF)
TAL は、公平性を保証し、TIL/ターゲット リソースの圧倒的な負荷を回避するために、可能な限り正確なパラメーターを提供する必要があります。

TAL に最大コスト フレームをデキューするのに十分なクレジットがない場合は、NdisWdiTxDequeueIndication の代わりに NdisWdiTxSendPauseIndication を発行する必要があります。

TxMgr は、 フレーム数、 フレーム コスト、または量子数の制限を超えるNET_BUFFER_LISTの一覧を返す場合があります。 これは、送信が完了した後、送信が延期され、シーケンス番号が同じで、フレームが 1 つの A-MSDU の一部として最初に送信されたことを示すシーケンス番号で再キューまたは再生されている場合にのみ発生します。

要件

要件
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
ヘッダー dot11wdi.h

こちらもご覧ください

NDIS_WDI_DATA_API

NET_BUFFER_LIST

NdisWdiTxDequeueIndication

NdisWdiTxSendPauseIndication

WDI TX パス