NDIS_WDI_TX_DEQUEUE_IND funzione di callback (dot11wdi.h)

Articolo
02/25/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 NdisWdiTxDequeueIndication viene chiamata nel contesto di un miniportWdiTxDataSend o MiniportWdiTxTalSend dal miniport IHV per dequeue frame da WDI al miniport IHV.

Questo è un callback all'interno di NDIS_WDI_DATA_API.

Sintassi

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

Parametri

[in] NdisMiniportDataPathHandle

NdisMiniportDataPathHandle passato al miniport IHV in MiniportWdiTalTxRxInitialize.

[in] Quantum

Quantistico. Per altre informazioni, vedere la sezione Host - target TX transfer scheduling in WDI TX path ( Percorso WDI TX).

[in] MaxNumFrames

Numero massimo di fotogrammi.

[in] Credit

Valore di credito. Per altre informazioni, vedere Schema di credito di destinazione e la sezione del meccanismo di sospensione/ripresa nel percorso WDI TX.

[out] ppNBL

Puntatore a un puntatore a una catena di NET_BUFFER_LIST dequeued da WDI.

Valore restituito

nessuno

Osservazioni

Un subset dei parametri potrebbe non essere applicabile a un dispositivo. Ad esempio, il numero massimo di fotogrammi potrebbe non essere applicato a un archivio e inoltrare un dispositivo (interfaccia del bus basata su messaggi).

I parametri seguenti vengono ignorati da TxMgr in queste circostanze.

Quantum se impostato su WDI_TX_QUANTUM_INVALID (0xFFFFFFFF )
MaxNumFrames se impostato su WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF )
Credito se impostato su WDI_TX_CREDIT_INVALID (0xFFFF )

Il TAL deve fornire parametri accurati ogni volta che è possibile garantire l'equità ed evitare risorse di TIL/destinazione travolgenti.

Se il TAL non dispone di un credito sufficiente per dequeuere un frame di costo massimo, dovrebbe emettere un NdisWdiTxSendPauseIndication anziché un NdisWdiTxDequeueIndication.

TxMgr può restituire un elenco di NET_BUFFER_LIST che superano il limite del numero di fotogrammi, costi fotogrammi o quantistici. Ciò avviene solo se i fotogrammi vengono riquettati/riprodotti dopo l'invio dopo l'invio con stato posticipato e con numero di sequenza identico, che indica che sono stati originariamente trasmessi come parte di un singolo A-MSDU.