NDIS_WDI_TX_DEQUEUE_IND fonction de rappel (dot11wdi.h)

Article
02/06/2025

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é dans 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’une MiniportWdiTxDataSend ou MiniportWdiTxTalSend par le miniport IHV pour déqueuer des 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 passé au miniport IHV dans MiniportWdiTalTxRxInitialize.

[in] Quantum

Le quantum. Pour plus d’informations, consultez la section Host - Target TX Transfer Planning dans chemin WDI TX.

[in] MaxNumFrames

Nombre maximal d’images.

[in] Credit

Valeur de crédit. Pour plus d’informations, consultez Le schéma de crédit cible et la section du mécanisme de pause/reprise dans chemin WDI TX.

[out] ppNBL

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

Valeur de retour

Aucun

Remarques

Un sous-ensemble des paramètres peut ne pas être applicable à un appareil. Par exemple, le nombre maximal d’images peut ne pas s’appliquer à un appareil de magasin et de transfert (interface de bus basée sur les messages).

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

Quantum s’il est défini sur WDI_TX_QUANTUM_INVALID (0xFFFFFFFF)
MaxNumFrames s’il est défini sur WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF)
de crédit s’il est défini sur 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’accablant les ressources TIL/cibles.

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

TxMgr peut renvoyer une liste de NET_BUFFER_LIST qui dépasse la limite du nombre d’images, de coûts d’images ou de quantum. Cela se produit uniquement si les images sont requeuées/relecturées après avoir été envoyées avec l’état Différé 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.