NDIS_WDI_TX_DEQUEUE_IND fonction de rappel (dot11wdi.h)

Article
08/07/2023

Important

Cette rubrique fait partie du modèle de pilote WDI publié dans Windows 10. Le modèle de pilote WDI est en mode maintenance et ne reçoit que des correctifs de priorité élevée. WiFiCx est le modèle de pilote Wi-Fi publié en Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.

La fonction de rappel NdisWdiTxDequeueIndication est appelée dans le contexte d’un MiniportWdiTxDataSend ou MiniportWdiTxTalSend par le miniport IHV pour déclasser les trames de WDI vers le miniport IHV.

Il s’agit d’un rappel à l’intérieur NDIS_WDI_DATA_API.

Syntaxe

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
)
{...}

Paramètres

[in] NdisMiniportDataPathHandle

Le NdisMiniportDataPathHandle est passé au miniport IHV dans MiniportWdiTalTxRxInitialize.

[in] Quantum

Quantum. Pour plus d’informations, consultez la section Host - Target TX transfer scheduling dans WDI TX path.

[in] MaxNumFrames

Nombre maximal de trames.

[in] Credit

Valeur de crédit. Pour plus d’informations, consultez la section Schéma de crédit cible et mécanisme de pause/reprise dans le chemin D’accès TX WDI.

[out] ppNBL

Pointeur vers un pointeur vers une chaîne NET_BUFFER_LIST en file d’attente par WDI.

Valeur de retour

None

Remarques

Un sous-ensemble des paramètres peut ne pas s’appliquer à un appareil. Par instance, le nombre maximal de trames peut ne pas s’appliquer à un appareil de stockage et de transfert (interface de bus basée sur les messages).

Les paramètres suivants sont ignorés par TxMgr dans ces circonstances.

Quantum si défini sur WDI_TX_QUANTUM_INVALID (0xFFFFFFFF)
MaxNumFrames s’il est défini sur WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF)
Crédit si la valeur est WDI_TX_CREDIT_INVALID (0xFFFF)

Le TAL doit fournir des paramètres précis dans la mesure du possible pour garantir l’équité et éviter d’surcharger les ressources TIL/cibles.

Si le TAL n’a pas suffisamment de crédit pour mettre hors file d’attente une trame de coût maximal, il doit émettre un NdisWdiTxSendPauseIndication au lieu d’un NdisWdiTxDequeueIndication.

TxMgr peut retourner une liste de NET_BUFFER_LIST qui dépassent la limite du nombre d’images, du coût des images ou du quantum. Cela se produit uniquement si les images sont reléguées/relues après avoir été envoyées avec status de Report et avec un numéro de séquence identique, ce qui indique qu’elles ont été transmises à l’origine dans le cadre d’un seul A-MSDU.