NDIS_WDI_TX_DEQUEUE_IND funzione di callback (dot11wdi.h)

2025-02-06

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. Ti consigliamo di usare WiFiCx per sfruttare le funzionalità più recenti.

La funzione di callback NdisWdiTxDequeueIndication viene chiamata nel contesto di un MiniportWdiTxDataSend o MiniportWdiTxTalSend dal miniport IHV per dequeare i fotogrammi da WDI al miniport IHV.

Si tratta di 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

Quantum. Per altre informazioni, vedere la sezione Host - Pianificazione trasferimento TX di destinazione in percorso WDI TX.

[in] MaxNumFrames

Numero massimo di fotogrammi.

[in] Credit

Valore di credito. Per altre informazioni, vedere Il sistema di credito di destinazione e il meccanismo di sospensione/ripresa sezione percorso TX WDI.

[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 dispositivo di archiviazione e inoltro (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 di sovraccaricare le risorse TIL/target.

Se il TAL non dispone di un credito sufficiente per annullare la coda di un frame di costo massimo, deve emettere un NdisWdiTxSendPauseIndication anziché un NdisWdiTxDequeueIndication.

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