NDIS_WDI_TX_RELEASE_FRAMES_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 NdisWdiTxReleaseFrameIndication libère jusqu’à un nombre spécifié ou un coût agrégé d’images mis en file d’attente vers une combinaison peer-TID donnée lorsque la transmission est suspendue. Si les files d’attente spécifiées ne sont pas suspendues, aucune des NET_BUFFER_LISTs n’est libérée.

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

Syntaxe

NDIS_WDI_TX_RELEASE_FRAMES_IND NdisWdiTxReleaseFramesInd;

void NdisWdiTxReleaseFramesInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [in]  UINT32 ExTidBitmask,
  [in]  UINT8 MaxNumFrames,
  [in]  UINT16 Credit,
  [out] PNET_BUFFER_LIST *ppNBL
)
{...}

Paramètres

[in] NdisMiniportDataPathHandle

Le NdisMiniportDataPathHandle passé au miniport IHV dans MiniportWdiTalTxRxInitialize.

[in] PortId

ID de port. Doit être une valeur non générique.

[in] PeerId

ID d’homologue. Doit être une valeur non générique.

[in] ExTidBitmask

Masque de bits TID étendu.

[in] MaxNumFrames

Nombre maximal d’images. MaxNumFrames est ignoré s’il est défini sur WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF).

[in] Credit

Crédit. de crédit est ignoré s’il est défini sur WDI_TX_CREDIT_INVALID (0xFFFF).

[out] ppNBL

Pointeur vers un pointeur vers une chaîne de NET_BUFFER_LIST de trames libérées.

Valeur de retour

Aucun

Remarques

si l’une des files d’attente spécifiées est suspendue avec WDI_TX_PAUSE_REASON_PS, tal/Target n’émet pas cette indication tant qu’elle n’a pas reçu une MiniportWdiTxTalQueueInOrder indication pour cette file d’attente.

Cette indication n’est autorisée que lorsque TargetPriorityQueueing a la valeur false.

TxMgr peut renvoyer une liste de NET_BUFFER_LIST qui dépasse la limite du nombre d’images ou de coûts d’images. Cela se produit uniquement si les images sont requeué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.