MINIPORT_WDI_TX_TARGET_DESC_INIT 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 retorno de chamada MINIPORT_WDI_TX_TARGET_DESC_INIT associa um descritor TX de destino opaco ao NET_BUFFER_LIST (campo MiniportReserved[1] ) e (se aplicável) preenche o campo de custo TX (em unidades de crédito) no buffer WDI_FRAME_METADATA do NET_BUFFER_LIST (MiniportReserved[0]).

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_TARGET_DESC_INIT . Para obter mais informações, consulte a seção Exemplos a seguir.

Sintaxe

MINIPORT_WDI_TX_TARGET_DESC_INIT MiniportWdiTxTargetDescInit;

void MiniportWdiTxTargetDescInit(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  PNET_BUFFER_LIST pNBL,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Parâmetros

[in] MiniportTalTxRxContext

Identificador de dispositivo TAL retornado pelo miniporto IHV na função de retorno de chamada MINIPORT_WDI_TAL_TXRX_INITIALIZE .

[in] pNBL

Ponteiro para um único NET_BUFFER_LIST.

[out] pWifiStatus

Ponteiro para o status definido pelo IHV para indicar o resultado da função de retorno de chamada MINIPORT_WDI_TX_TARGET_DESC_INIT.

Retornar valor

Nenhum

Comentários

Uma status de NDIS_STATUS_RESOURCES só deve ser usada quando os descritores Tx são esgotados. O melhor comportamento ocorrerá se o miniporto IHV não usar NDIS_STATUS_RESOURCES. Qualquer status que não seja NDIS_STATUS_SUCCESS e NDIS_STATUS_RESOURCES deve ser usada para qualquer outro erro que indique que o miniporto ou firmware IHV não pode processar o NET_BUFFER_LIST.

O miniporto IHV pode utilizar o arquivo de fundo no NET_BUFFER usando as funções de retirada e avanço do NDIS apropriadas. O início do deslocamento do pacote deve ser restaurado antes ou na função de retorno de chamada MINIPORT_WDI_TX_TARGET_DESC_DEINIT. O TxMgr determina o comprimento do quadro durante o tempo de remoção para que qualquer alteração no comprimento do quadro no MINIPORT_WDI_TX_TARGET_DESC_INIT função de retorno de chamada seja incluída na limitação do tamanho da fila ao quantum. Nesse caso, o miniporto IHV deve ajustar adequadamente o quantum para levar em conta o delta.

Importante O miniporto IHV não tem permissão para fazer nenhuma indicação no contexto dessa chamada. O TxMgr serializa chamadas para TxTargetDescInitHandler.

Exemplos

Para definir um MINIPORT_WDI_TX_TARGET_DESC_INIT função de retorno de chamada, 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 de retorno de chamada MINIPORT_WDI_TX_TARGET_DESC_INIT chamada "MyTxTargetDescInit", use o tipo MINIPORT_WDI_TX_TARGET_DESC_INIT conforme mostrado neste exemplo de código:

MINIPORT_WDI_TX_TARGET_DESC_INIT MyTxTargetDescInit;

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

_Use_decl_annotations_
VOID
 MyTxTargetDescInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL,
    NDIS_STATUS *pWifiStatus
    )
  {...}

O tipo de função MINIPORT_WDI_TX_TARGET_DESC_INIT é 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_TARGET_DESC_INIT 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.