OID_WDI_TASK_CONNECT (dot11wificxintf.h)

Wichtig

Dieses Thema ist Teil des WiFiCx-Treibermodells. WiFiCx ist das Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features zu nutzen. Das vorherige Wi-Fi 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 Access Point oder einem Wi-Fi Direct GO herstellt.

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

Im Rahmen der Verbindung muss die IHV-Komponente mit dem BSS synchronisieren, authentifizieren und ihr zuordnen. 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 BSS-Kandidateneinträge zu finden. Sie kann die vom Host bereitgestellte Liste für die Verbindung verwenden. Sie kann versuchen, nacheinander eine Verbindung herzustellen. Der Host sortiert die Netzwerke nach RSSI, aber die IHV-Komponente kann ihre eigene Reihenfolge für die Verbindung verwenden. Wenn der Adapter nicht "Connect BSS Selection Override" angibt, darf er nur die vom Host für die Verbindung bereitgestellten Einträge verwenden. Der Host kann bei einer ausstehenden Verbindung einen Abbruch ausstellen. Beim Empfang des Abbruchs muss der Port die Verbindungsversuche beenden und eine Vervollständigung an den Host melden.

Wenn der Adapter "Connect BSS Selection Override" angibt, kann er selbst Scans durchführen, um kandidateneigene BSS-Einträge zu finden. Es kann eine Verbindung mit jedem gefundenen BSS-Eintrag herstellen, solange er die vom Host konfigurierten Parameter erfüllt. Sie sollte diese Auswahl optimieren, um sicherzustellen, dass sie alle konfigurierten Verbindungsqualitätsanforderungen erfüllt. Dies kann die Optimierung des Roam-Scans, die Optimierung der AP-Auswahl, das Optimieren des Zuordnungsprozesses und die Minimierung des erforderlichen Sicherheitshandschübes umfassen. Wenn das Gerät während einer Überprüfung zusätzliche Zuordnungsparameter für einen gefundenen BSS-Eintrag benötigt (z. B. PMKID für Roaming), kann es einen NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST Anzeigen senden, um die Parameter abzurufen. Sofern 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. Es muss den Host unterstützen, der einen zweiten Verbindungsaufruf an demselben Port ausgibt.

Die status des Verbindungsversuchs für jeden BSS-Eintrag muss vom Port am Ende des Zuordnungsversuchs gemeldet werden. Dies umfasst den erfolgreichen Versuch und auch alle fehlgeschlagenen Versuche. Der Port darf jederzeit nicht mehr als einem Access Point oder Wi-Fi Direct GO zugeordnet sein.

Während einer Verbindung muss der Port alle Verbindungen beibehalten, die an anderen Ports (z. B. Infrastructure oder Wi-Fi Direct) eingerichtet wurden. Der Port kann jedoch den Mittleren Zugriff auf die anderen Ports verringern, um die Verbindung abzuschließen. Während der Verbindung kann der Host Paketsendeanforderungen an andere Ports übermitteln.

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 Station 802.11 verwendet den PMKID-Cache für die Vorauthentifizierung für Zugriffspunkte, die den RSNA-Authentifizierungsalgorithmus (Robust Security Network Association) aktiviert haben. Wenn die Station 802.11 eine BSSID mit einer bereitgestellten PMKID verknüpft oder neu zugeordnet, muss die 802.11-Station die PMKID-Daten im RSN-Informationselement (RSN IE) ihres Zuordnungs- oder Reassociation-Frames 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 zum 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 TSpec nicht aushandeln und darf keine MSDU-Aggregation für die Übertragung durchführen.
• Der Port muss sicherstellen, dass das SPP A-MSDU-fähige Bit (Bit 10) des rsn-Funktionen-IE, den er überträgt, auf Null festgelegt ist. In diesem Modus werden nur PP A-MSDU unterstützt.

Die Verbindungsparameter dürfen nicht MFPEnabled und HostFIPSModeEnabled auf 1 festgelegt haben. Der Verwaltungsframeschutz (802.11w) erfordert, dass der Port bestimmte Verwaltungs- und Aktionsframes ver-/entschlüsseln kann, sodass er nicht für eine Verbindung im Host-FIPS-Modus aktiviert werden kann. Darüber hinaus sind Wake on Wireless LAN-Features im Host-FIPS-Modus nicht anwendbar.

Aufgabenparameter

TLV	Mehrere TLV-Instanzen zulässig	Optional	BESCHREIBUNG
WDI_TLV_CONNECT_PARAMETERS			Die Verbindungsparameter.
WDI_TLV_CONNECT_BSS_ENTRY	X		Die bevorzugte Liste der Kandidatenverbindungs-BSS-Einträge. Der Port sollte versuchen, eine Verbindung mit einem dieser BSS-Einträge herzustellen, bis die Liste erschöpft ist oder die Verbindung erfolgreich abgeschlossen wurde. Der Port kann die Einträge bei Bedarf neu erstellen. Wenn der Adapter das Überschreibungsbit "Connect BSS Selection Override" festgelegt hat, kann er eine BSS auswählen, die sich nicht in dieser Liste befindet, solange er der Liste Zulässig/Nicht zulässig folgt.

Vorgangsabschlussanzeige

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Nicht angeforderter Hinweis

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