NDIS_WDI_PEER_CREATE_IND 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 retorno de chamada NdisWdiPeerCreateIndication especifica uma ID de par a ser associada a um endereço MAC par.

Esse é um retorno de chamada dentro de NDIS_WDI_DATA_API.

Sintaxe

NDIS_WDI_PEER_CREATE_IND NdisWdiPeerCreateInd;

void NdisWdiPeerCreateInd(
  [in] NDIS_HANDLE NdisMiniportDataPathHandle,
  [in] WDI_PORT_ID PortId,
  [in] WDI_PEER_ID PeerId,
  [in] WDI_MAC_ADDRESS PeerAddr
)
{...}

Parâmetros

[in] NdisMiniportDataPathHandle

O NdisMiniportDataPathHandle passou para o miniporto IHV em MiniportWdiTalTxRxInitialize.

[in] PortId

A ID da porta.

[in] PeerId

A ID do par. Isso é usado para identificar o par em comandos e indicações subsequentes.

[in] PeerAddr

O endereço MAC par.

Valor de retorno

Nenhum

Observações

Isso deve ser recebido e processado antes da troca de quadros com o par.

Uma porta que opera no modo AP ou Wi-Fi Direct GO pode ter simultaneamente mais de um par (clientes). Quando uma porta está operando no modo AP ou Wi-Fi Direct GO, o miniporto IHV cria um 'par' para o tráfego endereçado em grupo (passando um endereço MAC de transmissão). Todo o tráfego de transmissão e multicast para essa porta está associado a esse par. No modo de enfileiramento de porta, a criação do par de grupo pelo miniporto IHV não é necessária, pois a classificação de quadroS Tx não ocorre nesse modo.

Uma porta que opera em qualquer modo pode criar um par de grupo.

Para facilitar a implementação do TDLS no componente IHV, uma porta que opera em STA ou Wi-Fi modo de cliente Direto pode ter simultaneamente mais de um par. Se o endereço MAC de destino de um quadro TX estiver associado a uma ID de par não AP/GO, o TxMgr enfileira o quadro com uma fila TID associada a esse par não AP/GO (se o WDI estiver operando no modo de enfileiramento PeerTID).

No modo de enfileiramento par, um par é criado com todas as TIDs pausadas com WDI_TX_PAUSE_REASON_PEER_CREATE.