OID_WDI_TASK_CONNECT (dot11wificxintf.h)

Wichtig

Dieses Thema ist Teil des WiFiCx-Treibermodells. WiFiCx ist das in Windows 11 veröffentlichte WLAN-Treibermodell. Es wird empfohlen, WiFiCx zu verwenden, um die neuesten Features nutzen zu können. Das vorherige WLAN-Treibermodell WDI befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität.

OID_WDI_TASK_CONNECT fordert an, dass die IHV-Komponente eine Verbindung mit einem Zugriffspunkt oder mit einem Wi-Fi Direct GO herstellt.

Objekt	Abbruchfähig	Standardpriorität (Hosttreiberrichtlinie)	Normale Ausführungszeit (Sekunden)
Port	Ja. Auf den Abbruch muss eine dot11-Rücksetzung folgen.	4	10

Als Teil der Verbindung muss die IHV-Komponente mit BSS synchronisiert, authentifiziert und zugeordnet werden. Der Host stellt die BSS-Einträge bereit, mit denen die IHV-Komponente eine Verbindung herstellen kann. Sobald die IHV-Komponente erfolgreich eine Verbindung mit einem dieser Einträge hergestellt hat, sollte sie den Verbindungsvorgang abschließen. Wenn keine Verbindung mit einem der BSS-Einträge hergestellt werden kann, sollte der Verbindungsvorgang mit einem Fehler abgeschlossen werden.

Die IHV-Komponente muss keine Überprüfung durchführen, um Kandidaten-BSS-Einträge zu finden. Sie kann die vom Host bereitgestellte Liste für die Verbindung verwenden. Sie kann versuchen, eine Verbindung mit jedem dieser Einträge nacheinander herzustellen. Der Host sortiert die Netzwerke nach RSSI, die IHV-Komponente kann jedoch eine eigene Reihenfolge für die Verbindung verwenden. Wenn der Adapter nicht „Außerkraftsetzen der Verbindungs-BSS-Auswahl“ angibt, muss er nur die vom Host für die Verbindung bereitgestellten Einträge verwenden. Der Host stellt möglicherweise einen Abbruch bei einer ausstehenden Verbindung aus. Beim Empfang des Abbruchs muss der Port die Verbindungsversuche beenden und dem Host einen Abschluss melden.

Wenn der Adapter „Außerkraftsetzen der Verbindungs-BSS-Auswahl“ angibt, kann er eigene Scans durchführen, um Kandidaten bSS-Einträge zu finden. Er kann eine Verbindung mit jedem gefundenen BSS-Eintrag herstellen, solange dieser die vom Host konfigurierten Parameter erfüllt. Er sollte diese Auswahl optimieren, um sicherzustellen, dass sie alle konfigurierten Verbindungsqualitätsanforderungen erfüllt. Dies könnte das Optimieren des Roamingscans, der AP-Auswahl, des Zuordnungsprozesses und das Minimieren des erforderlichen Sicherheits-Handshake umfassen. Wenn das Gerät während eines Scans zusätzliche Zuordnungsparameter für einen gefundenen BSS-Eintrag benötigt (z. B. PMKID für Roaming), kann es eine NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST-Indikation senden, um die Parameter abzurufen. Wenn verfügbar, konfiguriert der Host diese Parameter mit OID_WDI_SET_ASSOCIATION_PARAMETERS.

Wenn die Verbindung fehlschlägt oder abgebrochen wird, sollte der Port keine Einstellungen zurücksetzen, die möglicherweise außerhalb des Verbindungsbefehls konfiguriert wurden. Er muss den Host unterstützen, der einen zweiten Verbindungsaufruf am selben Port ausgibt.

Der Status des Verbindungsversuchs für jeden BSS-Eintrag muss vom Port am Ende des Zuordnungsversuchs gemeldet werden. Dies schließt den erfolgreichen Versuch sowie alle fehlgeschlagenen Versuche ein. Zu jedem Zeitpunkt darf der Port nicht mehr als einem Zugriffspunkt oder Wi-Fi Direct GO zugeordnet werden.

Während eine Verbindung besteht, muss der Port alle Verbindungen aufrechterhalten, die über andere Ports hergestellt wurden (z. B. Infrastruktur oder Wi-Fi Direct). Der Port kann jedoch den mittleren Zugriff verringern, der für die anderen Ports bereitgestellt wird, um die Verbindung abzuschließen. Während der Verbindung kann der Host Paketsendeanforderungen an andere Ports senden.

Wenn der Authentifizierungsalgorithmus, der für die Verbindung verwendet wird, eine 802.1x-Portautorisierung für den Netzwerkzugriff erfordert, autorisiert der Host den Port, nachdem der Zuordnungsvorgang erfolgreich abgeschlossen wurde.

Die 802.11-Station verwendet den PMKID-Cache für die Vorauthentifizierung für Zugriffspunkte, die den Robust Security Network Association-(RSNA-)Authentifizierungsalgorithmus aktiviert haben. Wenn sich die 802.11-Station mit einer BSSID assoziiert oder reassoziiert, die eine bereitgestellte PMKID hat, muss die 802.11-Station die PMKID-Daten im RSN-Informationselement (RSN IE) ihres Assoziations- oder Reassoziationsframes verwenden.

Wenn der Port die Unterstützung für den Host-FIPS-Modus in WIFI_STATION_CAPABILITIES deklariert, kann HostFIPSModeEnabled in den Verbindungsparametern auf 1 festgelegt werden.

Wenn HostFIPSModeEnabled auf 1 festgelegt ist, gelten die folgenden Regeln.

• Der Port muss die Richtlinien für das Senden/Empfangen von Datenframes in Sendevorgängen im FIPS-Modus und Empfangsvorgängen im FIPS-Modus befolgen.
• Der Port darf keine Unterstützung für ein QoS-Protokoll in der Zuordnungsanforderung deklarieren, die an einen Nicht-HT-Zugriffspunkt gesendet wird. QoS-Unterstützung ist für HT-Verbindungen erforderlich.
• Der Port darf keine TSpec aushandeln und darf keine MSDU-Aggregation übertragen.
• Der Port muss sicherstellen, dass das SPP A-MSDU-fähige Bit (Bit 10) der übertragenen RSN-Funktionen auf Null festgelegt ist. Nur PP A-MSDU wird in diesem Modus unterstützt.

Die Optionen MFPEnabled und HostFIPSModeEnabled der Verbindungsparameter dürfen nicht auf 1 festgelegt sein. Der Verwaltungsframeschutz (802.11w) erfordert den Port zum Verschlüsseln/Entschlüsseln bestimmter Verwaltungs- und Aktionsframes, sodass er für eine Verbindung im Host-FIPS-Modus nicht aktiviert werden kann. Darüber hinaus gelten Wake on Wireless LAN-Funktionen nicht im Host-FIPS-Modus.

WiFi 7- / MLO-Anforderungen

Windows stellt die Einstellung MloConnectionSupported in WDI_TLV_CONNECTION_SETTINGS bereit, die angibt, ob ein Treiber eine Verbindung mittels MLO verwenden kann. Wenn eine Verbindung mit einem sicheren Netzwerk hergestellt wird, kann der Treiber nur die in WDI_TLV_RSNA_AKM_CIPHER_SUITE angegebenen AKM- und Chiffrepaare verwenden. Die einzige Ausnahme ist, wenn die Authentifizierung/das Chiffre nicht Teil des RSNA IE ist.

Weitere Informationen finden Sie unter WiFiCx Wi-Fi 7-Featureanforderungen.

Aufgabenparameter

TLV	Mehrere zulässige TLV-Instanzen	Optional	Beschreibung
WDI_TLV_CONNECT_PARAMETERS			Die Verbindungsparameter.
WDI_TLV_CONNECT_BSS_ENTRY	X		Die bevorzugte Liste der Kandidaten-BSS-Einträge für Verbindungen. Der Port sollte versuchen, eine Verbindung mit einem dieser BSS-Einträge herzustellen, bis die Liste abgearbeitet ist oder die Verbindung erfolgreich hergestellt wurde. Der Port kann die Einträge bei Bedarf erneut priorisieren. Wenn der Adapter das Bit „Außerkraftsetzen der Verbindungs-BSS-Auswahl“ gesetzt hat, kann er einen BSS-Eintrag wählen, der nicht in dieser Liste enthalten ist, solange er der Liste Zulässig/Nicht zulässig entspricht.

Angabe des Vorgangsabschlusses

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Nicht angeforderte Indikation

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 11
Unterstützte Mindestversion (Server)	Windows Server 2022
Header	dot11wificxintf.h