MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT função de retorno de chamada (dot11wdi.h)

Importante

Este tópico faz parte do modelo de driver WDI lançado em Windows 10. O modelo de driver WDI está no modo de manutenção e receberá apenas correções de alta prioridade. WiFiCx é o modelo de driver Wi-Fi lançado em Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes.

A função de retorno de chamada TxSuspectFrameListAbort é implementada pelo miniporto IHV para informar ao TxEngine que o TxMgr identificou quadros suspeitos de estarem suspensos ou com conclusão pendente por um período significativo de tempo.

Sintaxe

MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT MiniportWdiTxSuspectFrameListAbort;

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

Parâmetros

MiniportTalTxRxContext

O identificador de dispositivo TAL retornado pelo miniporto IHV em MiniportWdiTalTxRxInitialize.

SuspectFrameContext

Informações de contexto sobre o quadro suspeito.

NumSuspectFrames

O número de quadros suspeitos.

SuspectFrameList

A lista de quadros suspeitos. Para obter mais informações, consulte a seção Comentários.

Retornar valor

Nenhum

Comentários

Registre sua implementação dessa função de retorno de chamada definindo o membro apropriado da estrutura NDIS_MINIPORT_WDI_DATA_HANDLERS .

Esse é um manipulador opcional. Se o miniporto IHV não implementar o comportamento desse retorno de chamada, ele não deverá definir o ponteiro de função no NDIS_MINIPORT_WDI_DATA_HANDLERS e o WDI não chamará esse manipulador. No entanto, se o comportamento desse retorno de chamada não for implementado, o ponteiro da função ainda poderá ser definido se o miniporto IHV usar SuspectFrameList para registrar o estado IHV para fins de diagnóstico.

Essa função de retorno de chamada informa ao TxEngine que o TxMgr identificou quadros suspeitos de estarem suspensos ou com conclusão pendente por um período significativo de tempo. A matriz SuspectFrameList de ponteiros NBL, da qual o ponteiro Next não é aplicável, representa quadros que o TxMgr está solicitando a conclusão do prompt, mesmo que isso resulte na não transmissão do quadro pelo ar.

O TxEngine pode marcar o status de um NBL na matriz SuspectFrameList chamando TxQuerySuspectFrameStatus do contexto de TxSuspectFrameListAbort com SuspectFrameContext passado para o manipulador. O TxMgr não chamará TxTargetDescDeinit para NBLs em SuspectFrameList durante a duração de TxSuspectFrameAbort, nem concluirá os quadros para NDIS.

Se o TxEngine ou firmware não tiver conhecimento ou estado para o quadro suspeito, ele não deverá emitir conclusões para esse quadro suspeito, pois isso pode causar corrupção no sistema e/ou conclusões duplas.

Se uma paralisação ou corrupção de firmware for detectada, uma notificação de NDIS_STATUS_WDI_INDICATION_FIRMWARE_STALLED deverá ser feita para tentar a recuperação.

Requisitos

Requisito	Valor
Cabeçalho	dot11wdi.h