NDIS_WDI_TX_RELEASE_FRAMES_IND - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// dot11wdi.h

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
)
{...}
View the official Windows Driver Kit DDI reference
// dot11wificxintf.h

NDIS_WDI_TX_RELEASE_FRAMES_IND NdisWdiTxReleaseFramesInd;

void NdisWdiTxReleaseFramesInd(
  NDIS_HANDLE NdisMiniportDataPathHandle,
  WDI_PORT_ID PortId,
  WDI_PEER_ID PeerId,
  UINT32 ExTidBitmask,
  UINT8 MaxNumFrames,
  UINT16 Credit,
  PNET_BUFFER_LIST *ppNBL
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-dot11wdi-ndis_wdi_tx_release_frames_ind)

NDIS_WDI_TX_RELEASE_FRAMES_IND callback function

Description

[!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 NdisWdiTxReleaseFrameIndication callback function releases up to a specified number or aggregate cost of frames queued to a given peer-TID combination when transmission is paused. If the specified queues are not paused, none of the NET_BUFFER_LISTs are released.

This is a callback inside NDIS_WDI_DATA_API.

Parameters

NdisMiniportDataPathHandle [in]

The NdisMiniportDataPathHandle passed to the IHV miniport in MiniportWdiTalTxRxInitialize.

PortId [in]

The port ID. Must be a non-wildcard value.

PeerId [in]

The peer ID. Must be a non-wildcard value.

ExTidBitmask [in]

The Extended TID bitmask.

MaxNumFrames [in]

Maximum frame count. MaxNumFrames is ignored if it is set to WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF).

Credit [in]

Credit. Credit is ignored if it is set to WDI_TX_CREDIT_INVALID (0xFFFF).

ppNBL [out]

Pointer to a pointer to a NET_BUFFER_LIST chain of released frames.

Remarks

if one of the specified queues is paused with WDI_TX_PAUSE_REASON_PS, the TAL/Target does not issue this indication until it has received a MiniportWdiTxTalQueueInOrder indication for that queue.

This indication is only allowed when TargetPriorityQueueing is false.

The TxMgr may return a list of NET_BUFFER_LIST that exceed the limit of the number of frames or frame cost. This only happens if the frames are being requeued after being send completed with status of Postponed and with identical sequence number, which indicates they were originally transmitted as part of a single A-MSDU.

See also

MiniportWdiTxTalQueueInOrder

NDIS_WDI_DATA_API

NET_BUFFER_LIST

WDI_PEER_ID

WDI_PORT_ID

WDI_TXRX_CAPABILITIES

WDI_TX_PAUSE_REASON


Windows Driver Kit DDI reference (nc-dot11wificxintf-ndis_wdi_tx_release_frames_ind)

Description

[!IMPORTANT] This topic is part of the WiFiCx driver model. 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 previous Wi-Fi driver model WDI is in maintenance mode and will only receive high priority fixes.

[!WARNING] Some information in this topic relates to prereleased product, which may be substantially modified before it is commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

This function is reserved for system use and should not be called in your code.

Parameters

NdisMiniportDataPathHandle

Reserved.

PortId

Reserved.

PeerId

Reserved.

ExTidBitmask

Reserved.

MaxNumFrames

Reserved.

Credit

Reserved.

ppNBL

Reserved.

Remarks

See also