802.11 Wireless Diagnostics Extensible Helper Classes

Die integrierte drahtlose Diagnose-Infrastruktur verfügt über zwei Erweiterungspunkte.

Übergeordnete Hilfsklasse	Zweck
Überarbeitete RNWF-Klasse (Native Wifi) Extensible Helper Class	Diagnostiziert Probleme im Zusammenhang mit 802.11-Konnektivitätserweiterungen.
L2Security Extensible Helper Class	Diagnostiziert Probleme im Zusammenhang mit Layer 2-Sicherheitsprotokollerweiterungen.

 

Hinweis

Eine Hilfsklasse eines Drittanbieters sollte sich bei beiden übergeordneten Hilfsklassen registrieren, um sicherzustellen, dass die Drittanbieterklasse aufgerufen wird. Weitere Informationen zur Registrierung finden Sie unter Registrieren von NDF-Hilfsklassenerweiterungen.

 

RNWF Extensible Helper Class

Name der übergeordneten Hilfsklasse

Parent = L"RNWF Extensible Helper Class";

Die erweiterbare Hilfsprogrammklasse Revised Native Wifi (RNWF) ist das übergeordnete Element für Hilfsklassen von Drittanbietern, die Probleme im Zusammenhang mit der Erweiterung von 802.11-Protokollen diagnostizieren, die von Native Wifi verwendet werden.

Die beiden von der RNWF-Hilfsklasse bereitgestellten Schlüsselattribute sind die GUID der Schnittstelle, in der das Problem aufgetreten ist, und der Verbindungskontext.

• Schnittstellen-GUID: Dieses Attribut heißt "Schnittstellen-ID" und hat den Typ AT_GUID.

• Verbindungskontext: Dieses Attribut heißt Netzwerk-ID und ist vom Typ AT_OCTET_STRING. Diese Zeichenfolge ist tatsächlich ein Puffer der WDIAG_IHV_WLAN_ID Struktur, die in Wlanihv.h definiert ist. Diese Struktur wird wie folgt definiert.

#define WDIAG_IHV_WLAN_ID_FLAG_SECURITY_ENABLED 0x00000001 typedef struct _WDIAG_IHV_WLAN_ID { WCHAR strProfileName [MS_MAX_PROFILE_NAME_LENGTH]; DOT11_SSID Ssid; DOT11_BSS_TYPE BssType; DWORD dwFlags; Über DWORD dwReasonCode definierte Flags; Legen Sie nur fest, wenn ein anwendbarer Grundcode verfügbar ist } WDIAG_IHV_WLAN_ID, *PWDIAG_IHV_WLAN_ID; ```

Hinweis

WDIAG_IHV_WLAN_ID_FLAG_SECURITY_ENABLED ist der einzige mögliche dwFlags-Wert .

 

Das übereinstimmende Attribut für die Drittanbieterhilfsklasse sollte mit der Dienst-ID des entsprechenden Softwaremoduls identisch sein. Dies ist auch der Name, den der Drittanbieter in der Registrierung registrieren sollte. Wireless Diagnose fragt die Dienst-ID während der Drahtlosen Sitzung ab, in der das Problem aufgetreten ist. Die Informationen werden an NDF zurückgegeben, die bestimmt, ob die Drittanbieterhilfsklasse vorhanden und registriert ist, und sie dann aufrufen.

In der folgenden Tabelle sind die übereinstimmenden Attribute für die erweiterbare Hilfsklasse RNWF aufgeführt.

Name	type	Wert
DiagnosticsID	REG_SZ	[DiagnosticsID_GUID_String

 

L2Security Extensible Helper Class

Name der übergeordneten Hilfsklasse

Parent = L"Extensible L2Sec Helper Class";

Die erweiterbare Hilfsprogrammklasse Layer 2 Security (L2Security) ist das übergeordnete Element für Hilfsklassen von Drittanbietern, die Probleme im Zusammenhang mit entsprechenden Diensten und Softwaremodulen diagnostizieren, die die Sicherheitsfunktionen von Layer 2 ersetzen.

Die beiden von der Layer 2 Security-Hilfsklasse bereitgestellten Schlüsselattribute sind die GUID der Schnittstelle, in der das Problem aufgetreten ist, und der Verbindungskontext.

• Schnittstellen-GUID: Dieses Attribut heißt "Schnittstellen-ID" und hat den Typ AT_GUID.

• Verbindungskontext: Dieses Attribut heißt Netzwerk-ID und ist vom Typ AT_OCTET_STRING. Diese Zeichenfolge ist eigentlich ein Puffer der WDIAG_IHV_WLAN_ID-Struktur, die in wlanihv.h definiert ist. Diese Struktur wird wie folgt definiert.

#define WDIAG_IHV_WLAN_ID_FLAG_SECURITY_ENABLED 0x00000001 typedef struct _WDIAG_IHV_WLAN_ID { WCHAR strProfileName [MS_MAX_PROFILE_NAME_LENGTH]; DOT11_SSID Ssid; DOT11_BSS_TYPE BssType; DWORD dwFlags; Über DWORD dwReasonCode definierte Flags; Legen Sie nur fest, wenn ein anwendbarer Grundcode verfügbar ist } WDIAG_IHV_WLAN_ID, *PWDIAG_IHV_WLAN_ID; ```

Hinweis

WDIAG_IHV_WLAN_ID_FLAG_SECURITY_ENABLED ist der einzige mögliche dwFlags-Wert .

 

Das übereinstimmende Attribut für die Drittanbieterhilfsklasse sollte mit der Dienst-ID des entsprechenden Softwaremoduls identisch sein. Dies ist auch der Name, den der Drittanbieter in der Registrierung registrieren sollte. Wireless Diagnose fragt die Dienst-ID während der Drahtlosen Sitzung ab, in der das Problem aufgetreten ist. Die Informationen werden an NDF zurückgegeben, die bestimmt, ob die Drittanbieterhilfsklasse vorhanden und registriert ist, und sie dann aufrufen.

In der folgenden Tabelle sind die übereinstimmenden Attribute für die erweiterbare Hilfsklasse Layer 2 Security aufgeführt.

Name	type	Wert
DiagnosticsID	REG_SZ	[DiagnosticsID_GUID_String

 

Übereinstimmende Attribute

DiagnosticsID

802.11 Wireless Diagnostics fragt die DiagnosticsID vom nativen Wlan-Kerndienst ab, um herauszufinden, ob Drahtloserweiterungen oder Sicherheitsmodule von Drittanbietern installiert und an der Verbindung beteiligt sind. Die Drahtlose Diagnose stellt dann Hypothesen für diese Hilfsklassen von Drittanbietern bereit, wobei die DiagnosticsID als übereinstimmende Attribut verwendet wird. Alle Hilfsklassen von Drittanbietern sollten im zugehörigen Treiberpaket enthalten und mit diesem installiert werden. Die DiagnosticsID wird in der Miniport-INF-Datei als Registrierungsschlüssel in der AddReg-Direktive definiert.

HKR,Ndi\IHVExtensions, DiagnosticsID,0, "<Diagnostics ID GUID>"

Dieser Schlüssel definiert die ID der Wireless Helper-Klasse für das Softwaremodul eines Drittanbieters. Dieser Schlüssel ist optional für das Erweiterbarkeitsframework, aber er wird benötigt, wenn die Implementierung eine IHV Wireless Helper-Klasse enthält, die an NDF anschließt und Konnektivitätsprobleme im Zusammenhang mit der RNWF-Drahtlos- oder Sicherheitserweiterung diagnostizieren kann. MS WLAN-Diagnose-Hilfsklassen werden diese ID beim Drahtlosen Automatischen Konfigurationsdienst abfragen, wenn IHV-Module installiert sind, und geben diese ID während einer Diagnose Sitzung als Verweis oder übereinstimmende Attribut für NDF an, sodass NDF bei Bedarf die entsprechende Wireless-Hilfsklasse von Drittanbietern aufrufen kann.

[DiagnosticsID_GUID_String]

Dieser Wert muss eine Zeichenfolge aller Großbuchstaben sein. Beispiel: "{12345678-9ABC-DEF0-1234-56789ABCDEF0}".

Bereich von 802.11 Wireless Diagnostics Helper Classes

802.11 Wireless Diagnose-Hilfsklassen diagnostizieren derzeit Drahtlose Probleme in den folgenden Bereichen.

• Alle 802.11-Konnektivitätsprobleme, einschließlich 802.11-Zuordnung, 802.11-Authentifizierung, 802.11-Sicherheitseinstellungen im Zusammenhang mit 802.11-Standardprotokollen & , die im Betriebssystem nativ unterstützt werden, und Leistungsprobleme.
• Layer 2 Sicherheitsprobleme in Bezug auf 802.1x-Konfigurationen und alle Probleme im Zusammenhang mit der Layer-2-Authentifizierung mithilfe von Methoden, die nativ unter Windows Vista und Windows Server 2008 unterstützt werden.
• Die Konfiguration stimmt nicht in den Profileinstellungen zwischen dem Client und dem Access Point oder der Netzwerkinfrastruktur und den Diensten überein.

802.11 Wireless Diagnose Hilfsklassen diagnostizieren derzeit keine Drahtlosen Probleme in den folgenden Bereichen.

• Probleme im Zusammenhang mit 802.11-Erweiterungen von Drittanbietern, einschließlich Profil- oder Treibereinstellungen im Zusammenhang mit diesen Erweiterungen.
• Probleme im Zusammenhang mit EAP-Methoden von Drittanbietern.
• Probleme mit dem Wireless-Miniporttreiber.
• Alle 802.11- und Layer 2-Sicherheitsprotokolle oder Standardprobleme, die nicht nativ unterstützt werden.
• Probleme auf System- oder Komponentenebene, die sich auf die drahtlose Konnektivität auswirken können, z. B. Energieverwaltung, geringer Speicherplatz, Arbeitsspeicherbedingungen und Hardwareprobleme.

Darüber hinaus analysiert 802.11 Wireless Diagnostics keine HighUtilization-Fälle . Identifizierte Drahtlosleistungsprobleme werden analysiert und als LowHealth-Fälle gemeldet.