estrutura L2_NOTIFICATION_DATA (l2cmn.h)

Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.

 

A estrutura de L2_NOTIFICATION_DATA é usada pela DLL de Extensões IHV para enviar notificações a qualquer serviço ou aplicativos registrados para a notificação.

Sintaxe

typedef struct _L2_NOTIFICATION_DATA {
  DWORD NotificationSource;
  DWORD NotificationCode;
  GUID  InterfaceGuid;
  DWORD dwDataSize;
#if ...
  PBYTE pData;
#else
  PVOID pData;
#endif
} L2_NOTIFICATION_DATA, *PL2_NOTIFICATION_DATA;

Membros

NotificationSource

Esse membro especifica de onde vem a notificação. A DLL de Extensões IHV deve definir esse membro como L2_NOTIFICATION_SOURCE_WLAN_IHV.

NotificationCode

Esse membro especifica o código de notificação para a indicação de status. Esse código de notificação não deve ter o bit 0x10000 definido.

InterfaceGuid

O GUID (identificador global exclusivo) para o adaptador WLAN (LAN sem fio).

O sistema operacional passa o GUID e outros dados relacionados ao adaptador WLAN por meio do parâmetro pDot11Adapter da função Dot11ExtIhvInitAdapter , que o sistema operacional chama quando detecta a chegada do adaptador WLAN. Para obter mais informações sobre essa operação, consulte Chegada do adaptador WLAN 802.11.

dwDataSize

O comprimento, em bytes, dos dados dentro do buffer referenciado pelo membro pData . A DLL de Extensões IHV deve definir esse membro como zero se dados adicionais não forem necessários para a notificação.

pData

O endereço de um buffer alocado pelo chamador que contém dados adicionais para a notificação. O formato dos dados é definido pelo IHV (fornecedor independente de hardware).

A DLL de Extensões IHV deve definir esse membro como NULL se dados adicionais não forem necessários para a notificação.

Comentários

O aplicativo ou serviço se registra para receber notificações chamando a função ACM (Configuration Manager Automático) WlanRegisterNotification. Para obter mais informações sobre essa função, consulte a documentação do SDK do Microsoft Windows.

A DLL de Extensões IHV envia notificações para serviços ou aplicativos registrados chamando a função Dot11ExtSendNotification . O serviço ou aplicativo deve se registrar para receber notificações de uma fonte de L2_NOTIFICATION_SOURCE_WLAN_IHV.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	l2cmn.h (inclua Wlanihv.h)

Confira também

Dot11ExtIhvInitAdapter

Dot11ExtSendNotification