L2_NOTIFICATION_DATA Struktur (l2cmn.h)

Artikel
02/28/2024

Wichtig Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows-Treibermodell.

Die L2_NOTIFICATION_DATA-Struktur wird von der IHV-Erweiterungen-DLL verwendet, um Benachrichtigungen an alle Dienste oder Anwendungen zu senden, die für die Benachrichtigung registriert sind.

Syntax

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;

Member

NotificationSource

Dieses Element gibt an, wo die Benachrichtigung stammt. Die DLL für IHV-Erweiterungen muss diesen Member auf L2_NOTIFICATION_SOURCE_WLAN_IHV festlegen.

NotificationCode

Dieses Element gibt den Benachrichtigungscode für die status-Angabe an. Für diesen Benachrichtigungscode darf das Bit nicht 0x10000 festgelegt sein.

InterfaceGuid

Der globally unique Identifier (GUID) für den WLAN-Adapter (Wireless LAN).

Das Betriebssystem übergibt die GUID und andere Daten im Zusammenhang mit dem WLAN-Adapter über den pDot11Adapter-Parameter der Dot11ExtIhvInitAdapter-Funktion , die das Betriebssystem aufruft, wenn es die Ankunft des WLAN-Adapters erkennt. Weitere Informationen zu diesem Vorgang finden Sie unter 802.11 WLAN Adapter Arrival.

dwDataSize

Die Länge der Daten innerhalb des Puffers, auf die vom pData-Member verwiesen wird, in Bytes. Die DLL für IHV-Erweiterungen muss diesen Member auf 0 festlegen, wenn keine zusätzlichen Daten für die Benachrichtigung erforderlich sind.

pData

Die Adresse eines vom Aufrufer zugewiesenen Puffers, der zusätzliche Daten für die Benachrichtigung enthält. Das Format der Daten wird vom unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) definiert.

Die DLL für IHV-Erweiterungen muss diesen Member auf NULL festlegen, wenn keine zusätzlichen Daten für die Benachrichtigung erforderlich sind.

Hinweise

Die Anwendung oder der Dienst registriert sich zum Empfangen von Benachrichtigungen, indem die Funktion WlanRegisterNotification Auto Configuration Manager (ACM) aufgerufen wird. Weitere Informationen zu dieser Funktion finden Sie in der Microsoft Windows SDK Dokumentation.

Die DLL für IHV-Erweiterungen sendet Benachrichtigungen an registrierte Dienste oder Anwendungen, indem die Funktion Dot11ExtSendNotification aufgerufen wird. Der Dienst oder die Anwendung muss registriert werden, um Benachrichtigungen von einer Quelle mit L2_NOTIFICATION_SOURCE_WLAN_IHV empfangen zu können.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	l2cmn.h (include Wlanihv.h)

Weitere Informationen

Dot11ExtIhvInitAdapter

Dot11ExtSendNotification

Freigeben über