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

Artigo
02/06/2025

Importante

Este tópico faz parte do modelo de driver WDI lançado no 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 no Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes.

A função de manipulador MiniportWdiTalTxRxInitialize inicializa estruturas de dados no TAL e troca identificadores de componente de datapath entre a UE e o TAL. Isso é emitido no contexto da inicialização do driver e é emitido antes de consultar o firmware para os recursos do dispositivo.

Este é um manipulador de miniporto WDI dentro de NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

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

Sintaxe

MINIPORT_WDI_TAL_TXRX_INITIALIZE MiniportWdiTalTxrxInitialize;

NDIS_STATUS MiniportWdiTalTxrxInitialize(
  [in]      NDIS_HANDLE MiniportAdapterContext,
  [in]      NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]      PNDIS_WDI_DATA_API NdisWdiDataPathApi,
  [out]     PTAL_TXRX_HANDLE pMiniportTalTxRxContext,
  [in, out] PNDIS_MINIPORT_WDI_DATA_HANDLERS pMiniportDataHandlers,
  [out]     UINT32 *pMiniportWdiFrameMetadataExtraSpace
)
{...}

Parâmetros

[in] MiniportAdapterContext

Manipule o contexto do miniporto IHV.

[in] NdisMiniportDataPathHandle

Manipule o miniporto IHV a ser usado em indicações de datapath.

[in] NdisWdiDataPathApi

Ponteiro para a tabela de funções da API de dados WDI.

[out] pMiniportTalTxRxContext

O identificador de dispositivo TAL é um identificador de caminho de controle para o dispositivo (por exemplo, MiniportContext). Ele está associado ao MiniportHandle, que é usado como contexto para chamadas à API do NDIS.

[in, out] pMiniportDataHandlers

A UE inicializa o campo Cabeçalho NDIS para que o LE possa determinar a revisão e o tamanho seguros para inicializar de acordo com as regras tradicionais de controle de versão do NDIS. O LE é responsável por atualizar o Cabeçalho com a revisão e o tamanho que o LE realmente implementa e dá suporte antes de retornar.

[out] pMiniportWdiFrameMetadataExtraSpace

O LE define o valor apontado por esse parâmetro para a quantidade de espaço que o WDI deve reservar após o WDI_FRAME_METADATA para o LE usar.

Valor de retorno

Observação valores retornados nãoNDIS_STATUS_SUCCESS indicam uma falha genérica.

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	Indica que o driver de miniporto trocou com êxito as alças do componente datapath.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
cabeçalho	dot11wdi.h

Consulte também

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

TAL_TXRX_HANDLE

interfaces gerais de datapath do WDI

WDI_FRAME_METADATA

Partilhar via