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

[アーティクル]
08/07/2023

重要

このトピックは、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)
MaxNumFrames を WDI_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