MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT Rückruffunktion (dot11wdi.h)

  • Artikel

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 TxSuspectFrameListAbort-Rückruffunktion wird vom IHV-Miniport implementiert, um die TxEngine darüber zu informieren, dass die TxMgr Frames identifiziert hat, die verdächtigt werden, für eine längere Zeit hängend oder abgeschlossen zu werden.

Syntax

MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT MiniportWdiTxSuspectFrameListAbort;

void MiniportWdiTxSuspectFrameListAbort(
  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  UINT64 SuspectFrameContext,
  UINT16 NumSuspectFrames,
  PNET_BUFFER_LIST *SuspectFrameList
)
{...}

Parameter

MiniportTalTxRxContext

Das TAL-Gerätehandle, das vom IHV-Miniport in MiniportWdiTalTxRxInitialize zurückgegeben wird.

SuspectFrameContext

Kontextinformationen zum vermuteten Frame.

NumSuspectFrames

Die Anzahl der verdächtigen Frames.

SuspectFrameList

Die Liste der vermuteten Frames. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Rückgabewert

Keine

Bemerkungen

Registrieren Sie Ihre Implementierung dieser Rückruffunktion, indem Sie den entsprechenden Member der NDIS_MINIPORT_WDI_DATA_HANDLERS-Struktur festlegen.

Dies ist ein optionaler Handler. Wenn der IHV-Miniport das Verhalten dieses Rückrufs nicht implementiert, sollte er den Funktionszeiger nicht in NDIS_MINIPORT_WDI_DATA_HANDLERS festlegen, und WDI ruft diesen Handler nicht auf. Wenn das Verhalten dieses Rückrufs jedoch nicht implementiert wird, wird der Funktionszeiger möglicherweise trotzdem festgelegt, wenn der IHV-Miniport den SuspectFrameList-Status zu Diagnosezwecken protokolliert.

Diese Rückruffunktion informiert die TxEngine darüber, dass der TxMgr Frames identifiziert hat, die vermutet werden, dass sie hängen oder für einen längeren Zeitraum ausstehen. Das SuspectFrameList-Array von NBL-Zeigern, für die der Next-Zeiger nicht anwendbar ist, stellt Frames dar, die von TxMgr angefordert werden, auch wenn dies dazu führt, dass der Frame nicht über die Luft übertragen wird.

Die TxEngine überprüft möglicherweise die status einer NBL im SuspectFrameList-Array, indem TxQuerySuspectFrameStatus aus dem Kontext von TxSuspectFrameListAbort mit dem an den Handler übergebenen SuspectFrameContext aufgerufen wird. TxMgr ruft während der Dauer von TxSuspectFrameAbort weder TxTargetDescDeinit für NBLs in SuspectFrameList auf, noch vervollständigen sie die Frames in NDIS.

Wenn die TxEngine oder Firmware über keine Kenntnisse oder einen Zustand für den verdächtigen Frame verfügt, sollte sie keine Vervollständigungen für diesen verdächtigen Frame ausgeben, da dies zu Systembeschädigungen und/oder doppelten Vervollständigungen führen kann.

Wenn ein Firmware-Stillstand oder eine Beschädigung erkannt wird, sollte eine NDIS_STATUS_WDI_INDICATION_FIRMWARE_STALLED Benachrichtigung erstellt werden, um die Wiederherstellung zu versuchen.

Anforderungen

Anforderung Wert
Header dot11wdi.h