L2_NOTIFICATION_DATA structure (l2cmn.h)

Article
02/28/2024

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez l’interface WDI (Wlan Device Driver Interface) à la place. Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

La structure L2_NOTIFICATION_DATA est utilisée par la DLL des extensions IHV pour envoyer des notifications à tout service ou application qui s’est inscrit pour la notification.

Syntaxe

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;

Membres

NotificationSource

Ce membre spécifie d’où provient la notification. La DLL extensions IHV doit définir ce membre sur L2_NOTIFICATION_SOURCE_WLAN_IHV.

NotificationCode

Ce membre spécifie le code de notification pour l’indication status. Ce code de notification ne doit pas avoir le bit 0x10000 défini.

InterfaceGuid

Identificateur global unique (GUID) de l’adaptateur LAN sans fil (WLAN).

Le système d’exploitation transmet le GUID et d’autres données liées à l’adaptateur WLAN via le paramètre pDot11Adapter de la fonction Dot11ExtIhvInitAdapter , que le système d’exploitation appelle lorsqu’il détecte l’arrivée de l’adaptateur WLAN. Pour plus d’informations sur cette opération, consultez Arrivée de l’adaptateur WLAN 802.11.

dwDataSize

Longueur, en octets, des données dans la mémoire tampon référencées par le membre pData . La DLL extensions IHV doit définir ce membre sur zéro si des données supplémentaires ne sont pas requises pour la notification.

pData

Adresse d’une mémoire tampon allouée à l’appelant qui contient des données supplémentaires pour la notification. Le format des données est défini par le fournisseur de matériel indépendant (IHV).

La DLL des extensions IHV doit définir ce membre sur NULL si des données supplémentaires ne sont pas requises pour la notification.

Remarques

L’application ou le service s’inscrit pour recevoir des notifications en appelant la fonction WlanRegisterNotification Auto Configuration Manager (ACM). Pour plus d’informations sur cette fonction, reportez-vous à la documentation Microsoft Windows SDK.

La DLL extensions IHV envoie des notifications aux services ou applications inscrits en appelant la fonction Dot11ExtSendNotification . Le service ou l’application doit s’inscrire pour recevoir des notifications d’une source de L2_NOTIFICATION_SOURCE_WLAN_IHV.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	l2cmn.h (incluez Wlanihv.h)

Voir aussi

Dot11ExtIhvInitAdapter

Dot11ExtSendNotification

Partager via