NDIS_WDI_TX_RELEASE_FRAMES_IND fonction de rappel (dot11wdi.h)

Article
02/23/2024

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é des images mises en file d’attente vers une combinaison pair-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 de 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 est 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. Le 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 NET_BUFFER_LIST d’images libérées.

Valeur de retour

None

Remarques

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

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

TxMgr peut renvoyer une liste de NET_BUFFER_LIST qui dépassent la limite du nombre d’images ou du coût des images. Cela se produit uniquement si les images sont remises en file d’attente après avoir été envoyées avec status de différé et avec le numéro de séquence identique, ce qui indique qu’elles ont été transmises à l’origine dans le cadre d’une seule A-MSDU.