NDIS_WDI_TX_RELEASE_FRAMES_IND funzione di callback (dot11wdi.h)

Articolo
02/23/2024

Importante

Questo argomento fa parte del modello di driver WDI rilasciato in Windows 10. Il modello di driver WDI è in modalità di manutenzione e riceverà solo correzioni con priorità elevata. WiFiCx è il modello di driver Wi-Fi rilasciato in Windows 11. È consigliabile usare WiFiCx per sfruttare le funzionalità più recenti.

La funzione callback NdisWdiTxReleaseIndication rilascia fino a un numero o un costo aggregato di frame accodati a una determinata combinazione peer-TID quando la trasmissione viene sospesa. Se le code specificate non vengono sospese, nessuna delle NET_BUFFER_LISTs viene rilasciata.

Questo è un callback all'interno di NDIS_WDI_DATA_API.

Sintassi

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

Parametri

[in] NdisMiniportDataPathHandle

NdisMiniportDataPathHandle passato al miniport IHV in MiniportWdiTalTxRxInitialize.

[in] PortId

ID porta. Deve essere un valore non jolly.

[in] PeerId

ID peer. Deve essere un valore non jolly.

[in] ExTidBitmask

Maschera di bit TID estesa.

[in] MaxNumFrames

Numero massimo di fotogrammi. MaxNumFrames viene ignorato se è impostato su WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF ).

[in] Credit

Credito. Il credito viene ignorato se è impostato su WDI_TX_CREDIT_INVALID (0xFFFF ).

[out] ppNBL

Puntatore a un puntatore a una catena NET_BUFFER_LIST di fotogrammi rilasciati.

Valore restituito

nessuno

Osservazioni

se una delle code specificate viene sospesa con WDI_TX_PAUSE_REASON_PS, il TAL/Target non rilascia questa indicazione finché non ha ricevuto un'indicazione MiniportWdiTxTalQueueInOrder per tale coda.

Questa indicazione è consentita solo quando TargetPriorityQueueing è false.

TxMgr può restituire un elenco di NET_BUFFER_LIST che superano il limite del numero di fotogrammi o costi del frame. Ciò accade solo se i fotogrammi vengono riquecati dopo l'invio completato con lo stato di Rinvio e con numero di sequenza identico, che indica che sono stati originariamente trasmessi come parte di un singolo A-MSDU.