NDIS_WDI_PEER_DELETE_IND callback function (dot11wdi.h)

Article
10/22/2021

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 NdisWdiPeerDeleteIndication callback function initiates the removal of the association of between a peer ID and a peer MAC address. Once this indication is processed, the peer ID can no longer be used in subsequent Rx indications and the IHV may not inject any Tx frames for this peer.

This is a callback inside NDIS_WDI_DATA_API.

Syntax

NDIS_WDI_PEER_DELETE_IND NdisWdiPeerDeleteInd;

void NdisWdiPeerDeleteInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Parameters

[in] NdisMiniportDataPathHandle

The NdisMiniportDataPathHandle passed to IHV miniport in MiniportWdiTalTxRxInitialize.

[in] PortId

The port ID.

[in] PeerId

The peer ID.

[out] pWifiStatus

Indicates whether the peer deletion completed synchronously (if status is set to NDIS_STATUS_SUCCESS), or whether WDI will issue a MiniportWdiTalTxRxPeerDeleteConfirm when peer deletion completes.

Return value

None

Remarks

In PeerQueueing mode, the TxMgr issues a TxAbort for the peer. If the MiniportWdiTxAbort completes synchronously and there are no outstanding TX frames for that peer, WDI_STATUS is set to NDIS_STATUS_SUCCESS and the peer deletion is complete (see MiniportWdiTalTxRxPeerDeleteConfirm for the description of a peer delete completion). Otherwise, WDI issues a MiniportWdiTalTxRxPeerDeleteConfirm when the TxAbort is completed and there are no outstanding frames for this peer.

Requirements

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