MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT funzione di callback (dot11wdi.h)

  • Articolo

Importante

Questo argomento fa parte del modello di driver WDI rilasciato in Windows 10. Il modello di driver WDI è in modalità di manutenzione e riceverà solo correzioni con priorità elevata. WiFiCx è il modello di driver Wi-Fi rilasciato in Windows 11. È consigliabile usare WiFiCx per sfruttare le funzionalità più recenti.

La funzione di callback TxSuspectFrameListAbort viene implementata dal miniport IHV per informare il TxEngine che il TxMgr ha identificato fotogrammi sospetti di essere sospesi o in sospeso per un periodo di tempo significativo.

Sintassi

MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT MiniportWdiTxSuspectFrameListAbort;

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

Parametri

MiniportTalTxRxContext

L'handle del dispositivo TAL restituito dal miniport IHV in MiniportWdiTalTxRxInitialize.

SuspectFrameContext

Informazioni di contesto sul frame sospetto.

NumSuspectFrames

Numero di fotogrammi sospetti.

SuspectFrameList

Elenco di fotogrammi sospetti. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

nessuno

Osservazioni

Registrare l'implementazione di questa funzione di callback impostando il membro appropriato della struttura NDIS_MINIPORT_WDI_DATA_HANDLERS .

Si tratta di un gestore facoltativo. Se il miniport IHV non implementa il comportamento del callback, non deve impostare il puntatore alla funzione in NDIS_MINIPORT_WDI_DATA_HANDLERS e WDI non chiamerà questo gestore. Tuttavia, se il comportamento del callback non viene implementato, il puntatore alla funzione potrebbe comunque essere impostato se il miniport IHV usa il oggetto SuspectFrameList per registrare lo stato IHV a scopo di diagnostica.

Questa funzione di callback informa il TxEngine che il TxMgr ha identificato fotogrammi sospetti di essere sospesi o in sospeso per un periodo di tempo significativo. La matrice SuspectFrameList di puntatori NBL, di cui il puntatore Successivo non è applicabile, rappresenta i frame che il TxMgr richiede il completamento della richiesta, anche se il frame non viene trasmesso sull'aria.

TxEngine potrebbe controllare lo stato di un NBL nella matrice SuspectFrameList chiamando TxQuerySuspectFrameStatus dal contesto di TxSuspectFrameListAbort con il gestore SuspectFrameContext passato al gestore. Il TxMgr non chiamerà TxTargetDescDeinit per eventuali NBLs in SuspectFrameList durante la durata di TxSuspectFrameAbort, né completerà i frame in NDIS.

Se il txengine o il firmware non ha conoscenza o stato per il frame sospetto che non deve rilasciare i completamento per tale frame sospetto, in quanto potrebbe causare il danneggiamento del sistema e/o il doppio completamento.

Se viene rilevato un arresto o un danneggiamento del firmware, è necessario eseguire una notifica di NDIS_STATUS_WDI_INDICATION_FIRMWARE_STALLED per tentare il ripristino.

Requisiti

Requisito Valore
Intestazione dot11wdi.h