MINIPORT_WDI_TAL_TXRX_INITIALIZE 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 MiniportWdiTalTxRxInitialize inicializa estruturas de dados no TAL e troca identificadores de componente de caminho de dados entre o UE e o TAL. Isso é emitido no contexto da inicialização do driver e é emitido antes de consultar o firmware quanto aos recursos do dispositivo.

Este é um manipulador de miniporto WDI dentro de NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Nota 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

Identificador para o contexto de miniporto IHV.

[in] NdisMiniportDataPathHandle

Identificador para o miniporto IHV a ser usado em indicações de caminho de dados.

[in] NdisWdiDataPathApi

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

[out] pMiniportTalTxRxContext

O identificador do 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 como a quantidade de espaço que o WDI deve reservar após o WDI_FRAME_METADATA para o LE usar.

Retornar valor

Nota Valores retornados não NDIS_STATUS_SUCCESS indicam uma falha genérica.

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	Indica que o driver de miniporta trocou com êxito os identificadores de componente de caminho de dados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Servidor mínimo com suporte	Windows Server 2016
Plataforma de Destino	Windows
Cabeçalho	dot11wdi.h

Confira também

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

TAL_TXRX_HANDLE

Interfaces de caminho de dados gerais do WDI

WDI_FRAME_METADATA

Compartilhar via