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

Artigo
08/07/2023

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 manipulador MiniportWdiTxAbort anula quadros TX pendentes para uma determinada porta ou par, o que inclui iniciar a conclusão de quadros pertencentes ao TAL/destino. Essa solicitação é emitida para o TAL como parte da manipulação de MiniportPause (anulação de TX em todo o adaptador), redefinição do dot11 (anulação em toda a porta) e após NdisWdiPeerDeleteIndication se o WDI estiver operando no modo de enfileiramento par.

Este é um manipulador de miniporto WDI dentro de NDIS_MINIPORT_WDI_DATA_HANDLERS.

Nota Você deve declarar a função usando o tipo MINIPORT_WDI_TX_ABORT . Para obter mais informações, consulte a seção Exemplos a seguir.

Sintaxe

MINIPORT_WDI_TX_ABORT MiniportWdiTxAbort;

void MiniportWdiTxAbort(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Parâmetros

[in] MiniportTalTxRxContext

Identificador de dispositivo TAL retornado pelo miniporto IHV em MiniportWdiTalTxRxInitialize.

[in] PortId

A ID da porta.

[in] PeerId

A ID do par.

[out] pWifiStatus

Ponteiro para um status do MiniportWdiTxAbort, que deve ser definido pelo miniporto IHV. Consulte a seção Comentários para obter mais informações.

Valor retornado

Nenhum

Comentários

Um curinga pode ser especificado para o PeerId parar o TX em uma porta.

Um curinga para PortId e PeerId pode ser especificado para interromper o TX no adaptador.

Para concluir a operação de parada, o TAL deve executar as etapas a seguir.

Inicie o retorno da propriedade de buffers de dados TX correspondentes aos parâmetros de entrada para o host. Esses quadros devem ser concluídos indicando a conclusão da transferência de todos os quadros passados para o TxEngine em solicitações de envio e indicando NdisWdiTxSendCompleteIndication para quadros TX pendentes que exigem a conclusão explícita do envio (se o quadro TX não foi transferido concluído com um código de êxito).
Retornar um status de êxito ou retornar um status pendente e o problema NdisWdiTxAbortConfirm posteriormente.

Exemplos

Para definir uma função MiniportWdiTxAbort, primeiro você deve fornecer uma declaração de função que identifique o tipo de função que você está definindo. O Windows fornece um conjunto de tipos de função para drivers. Declarar uma função usando os tipos de função ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para escrever drivers para o sistema operacional Windows.

Por exemplo, para definir uma função MiniportWdiTxAbort chamada "MyTxAbort", use o tipo MINIPORT_WDI_TX_ABORT conforme mostrado neste exemplo de código:

MINIPORT_WDI_TX_ABORT MyTxAbort;

Em seguida, implemente sua função da seguinte maneira:

_Use_decl_annotations_
VOID
 MyTxAbort(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PORT_ID PortId,
    WDI_PEER_ID PeerId,
    NDIS_STATUS *pWifiStatus
    )
  {...}

O tipo de função MINIPORT_WDI_TX_ABORT é definido no arquivo de cabeçalho dot11wdi.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função MINIPORT_WDI_TX_ABORT no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers NDIS.

Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.