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)
- MaxNumFrames を WDI_TX_MAX_FRAME_COUNT_INVALID に設定した場合 (0xFF)
- WDI_TX_CREDIT_INVALID に設定 されている場合の クレジット (0xFFFF)
TAL に最大コスト フレームをデキューするのに十分なクレジットがない場合は、NdisWdiTxDequeueIndication の代わりに NdisWdiTxSendPauseIndication を発行する必要があります。
TxMgr は、 フレーム数、 フレーム コスト、または量子数の制限を超えるNET_BUFFER_LISTの一覧を返す場合があります。 これは、送信が完了した後、送信が延期され、シーケンス番号が同じで、フレームが 1 つの A-MSDU の一部として最初に送信されたことを示すシーケンス番号で再キューまたは再生されている場合にのみ発生します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 |
| サポートされている最小のサーバー | Windows Server 2016 |
| 対象プラットフォーム | Windows |
| ヘッダー | dot11wdi.h |