OID_WDI_TASK_CONNECT

Wichtig

Dieses Thema ist Teil des WDI-Treibermodells, das in Windows 10 veröffentlicht wurde. Das WDI-Treibermodell befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität. 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.

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, sich authentifizieren und ihm zuordnen. Der Host stellt die BSS-Einträge bereit, mit denen die IHV-Komponente eine Verbindung herstellen kann. Nachdem 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 mögliche BSS-Einträge zu finden. Sie kann die vom Host bereitgestellte Liste für die Verbindung verwenden. Es kann versuchen, nacheinander eine Verbindung mit jedem herzustellen. Der Host sortiert die Netzwerke nach RSSI, aber die IHV-Komponente kann eine eigene Reihenfolge für die Verbindung verwenden. Wenn der Adapter nicht "Verbindungs-BSS-Auswahlüberschreibung" 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 dem Host einen Abschluss melden.

Wenn der Adapter "Connect BSS Selection Override" angibt, kann er selbst Überprüfungen durchführen, um potenzielle 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 das Optimieren von Roamingscans, die Optimierung der AP-Auswahl, das Optimieren des Zuordnungsprozesses und die Minimierung des erforderlichen Sicherheitshandshakes 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 eine NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST Anzeige 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 an demselben Port ausgibt.

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

Während der Verbindungsherstellung muss der Port alle Verbindungen beibehalten, die an anderen Ports (z. B. Infrastructure oder Wi-Fi Direct) hergestellt werden. Der Port kann jedoch den Mittleren Zugriff auf die anderen Ports verringern, um die Verbindung zu beenden. Während der Verbindung kann der Host Paketsendeanforderungen an andere Ports übermitteln.

Wenn der für die Verbindung verwendete Authentifizierungsalgorithmus 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 802.11-Station eine BSSID mit einer bereitgestellten PMKID ordnet oder neu zugeordnet, muss die Station 802.11 die PMKID-Daten im RSN-Informationselement (RSN IE) ihres Association- oder Reassociation-Frames verwenden.

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

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

• Der Port muss den Richtlinien zum Senden/Empfangen von Datenframes in Sendevorgängen im FIPS-Modus und Empfangsvorgängen im FIPS-Modus entsprechen.
• 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 keine MSDU-Aggregation übertragen.
• Der Port muss sicherstellen, dass das SPP A-MSDU-fähige Bit (Bit 10) der RSN-Funktionen IE, die er überträgt, auf Null festgelegt ist. In diesem Modus wird nur PP A-MSDU unterstützt.

Für die Verbindungsparameter dürfen nicht MFPEnabled und HostFIPSModeEnabled auf 1 festgelegt sein. Der Verwaltungsframeschutz (802.11w) erfordert den Port zum Ver-/Entschlüsseln bestimmter Verwaltungs- und Aktionsframes, 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 zulässige TLV-Instanzen	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 festlegen. Wenn der Adapter das Bit "Connect BSS Selection Override" festgelegt hat, kann er einen BSS auswählen, der nicht in dieser Liste enthalten ist, solange er der Liste Zulässig/Unzulässig folgt.

Vorgangsabschlussanzeige

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Unaufgebetene Anzeige

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

Anforderungen

Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Header	Dot11wdi.h