NDIS_WDI_TX_QUERY_RA_TID_STATE callback function (dot11wdi.h)

Article
02/22/2024

Important

This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features.

The NdisWdiTxQueryRATIDState callback function is used by the TxEngine to query the state of a RA/TID or Port queue.

This is a callback inside NDIS_WDI_DATA_API.

Syntax

NDIS_WDI_TX_QUERY_RA_TID_STATE NdisWdiTxQueryRaTidState;

void NdisWdiTxQueryRaTidState(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [in]  WDI_EXTENDED_TID ExTid,
  [out] NDIS_STATUS *pWifiStatus,
  [out] PUINT16 pQueueLength
)
{...}

Parameters

[in] NdisMiniportDataPathHandle

The NdisMiniportDataPathHandle passed to the IHV miniport in MiniportWdiTalTxRxInitialize.

[in] PortId

The port ID.

[in] PeerId

The peer ID.

[in] ExTid

The Extended Traffic ID (TID)

[out] pWifiStatus

Indicates the result of the query operation. See the Remarks section for more information.

[out] pQueueLength

The number of backlogged frames in the specified RA/TID or Port queue.

Return value

None

Remarks

The TxMgr returns a success status if the port and peer are valid. Otherwise, it returns an error status. In the case of a success status, the QueueLength is set to the number of backlogged frames in the specified RA/TID or Port queue.

If TargetPriorityQueueing is true, WDI_PEER_ID must be set to the wildcard peer value.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Target Platform	Windows
Header	dot11wdi.h