NDIS_WDI_TX_DEQUEUE_IND Rückruffunktion (dot11wdi.h)
Wichtig
Dieses Thema ist Teil des WDI-Treibermodells, das in Windows 10 veröffentlicht wurde. Das WDI-Treibermodell befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität. WiFiCx ist das Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features zu nutzen.
Die Rückruffunktion NdisWdiTxDequeueIndication wird im Kontext von MiniportWdiTxDataSend oder MiniportWdiTxTalSend durch den IHV-Miniport aufgerufen, um Frames von WDI in den IHV-Miniport zu dequeue.
Dies ist ein Rückruf innerhalb NDIS_WDI_DATA_API.
Syntax
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
)
{...}
Parameter
[in] NdisMiniportDataPathHandle
Der an den IHV-Miniport in MiniportWdiTalTxRxInitialize übergebene NdisMiniportDataPathHandle.
[in] Quantum
Das Quanten. Weitere Informationen finden Sie im Abschnitt Host – Ziel TX-Übertragungsplanung im WDI TX-Pfad.
[in] MaxNumFrames
Maximale Frameanzahl.
[in] Credit
Guthabenwert. Weitere Informationen finden Sie unter Das Zielguthabenschema und im Abschnitt Pause/Resume-Mechanismus im WDI TX-Pfad.
[out] ppNBL
Zeiger auf einen Zeiger auf eine NET_BUFFER_LIST Kette, die von WDI aus der Warteschlange entfernt wurde.
Rückgabewert
Keine
Bemerkungen
Eine Teilmenge der Parameter ist möglicherweise nicht auf ein Gerät anwendbar. Für instance gilt die maximale Frameanzahl möglicherweise nicht für ein Speicher- und Weiterleitungsgerät (nachrichtenbasierte Busschnittstelle).
Die folgenden Parameter werden von TxMgr unter diesen Umständen ignoriert.
- Quantum , wenn auf WDI_TX_QUANTUM_INVALID festgelegt (0xFFFFFFFF)
- MaxNumFrames , wenn auf WDI_TX_MAX_FRAME_COUNT_INVALID festgelegt (0xFF)
- Guthaben , wenn auf WDI_TX_CREDIT_INVALID festgelegt (0xFFFF)
Wenn die TAL nicht über genügend Guthaben verfügt, um einen maximalen Kostenrahmen aus der Warteschlange zu entfernen, sollte sie anstelle einer NdisWdiTxDequeueIndication eine NdisWdiTxDequeueIndication ausgeben.
Der TxMgr gibt möglicherweise eine Liste von NET_BUFFER_LIST zurück, die den Grenzwert der Anzahl von Frames, Framekosten oder Quanten überschreiten. Dies geschieht nur, wenn die Frames nach abschluss des Sendevorgangs mit status verschoben und mit identischer Sequenznummer erneut in die Warteschlange geschoben/wiedergegeben werden, was angibt, dass sie ursprünglich als Teil einer einzelnen A-MSDU übertragen wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Zielplattform | Windows |
| Kopfzeile | dot11wdi.h |