OID_WDI_TASK_CONNECT (dot11wificxintf.h)

Belangrijk

Dit onderwerp maakt deel uit van het WiFiCx-stuurprogrammamodel. WiFiCx is het Wi-Fi stuurprogrammamodel dat is uitgebracht in Windows 11. We raden u aan WiFiCx te gebruiken om te profiteren van de nieuwste functies. Het vorige Wi-Fi stuurprogrammamodel WDI- bevindt zich in de onderhoudsmodus en ontvangt alleen oplossingen met hoge prioriteit.

OID_WDI_TASK_CONNECT vraagt dat het IHV-onderdeel verbinding maakt met een toegangspunt of met een Wi-Fi Direct GO.

Object	Afgebroken geschikt	Standaardprioriteit (hoststuurprogrammabeleid)	Normale uitvoeringstijd (seconden)
Haven	Ja. Het afbreken moet worden gevolgd door een dot11-reset.	4	10

Als onderdeel van de verbinding moet het IHV-onderdeel synchroniseren met, verifiëren en koppelen aan de BSS. De host levert de BSS-vermeldingen waarmee het IHV-onderdeel verbinding kan maken. Zodra het IHV-onderdeel verbinding heeft gemaakt met een van deze vermeldingen, moet het verbindingsproces worden voltooid. Als het geen verbinding kan maken met een van de BSS-vermeldingen, moet het verbindingsproces worden voltooid met een fout.

Het IHV-onderdeel hoeft geen scan uit te voeren om kandidaat BSS-vermeldingen te vinden. Deze kan de lijst van de host gebruiken voor de verbinding. Het kan proberen om verbinding te maken met elk ervan, één na elkaar. De host sorteert de netwerken op RSSI, maar het IHV-onderdeel kan een eigen volgorde voor verbinding gebruiken. Als de adapter geen "Connect BSS Selection Override" opgeeft, mag deze alleen de vermeldingen van de host gebruiken voor de verbinding. De host kan een abort op een openstaande verbinding uitgeven. Als de poort wordt afgebroken, moet de poort de verbindingspogingen beëindigen en een voltooiing aan de host rapporteren.

Als de adapter "Connect BSS Selection Override" opgeeft, kan deze zelf scans uitvoeren om kandidaat BSS-vermeldingen te vinden. Het kan verbinding maken met elke BSS-vermelding die wordt gevonden zolang deze voldoet aan de parameters die door de host zijn geconfigureerd. Deze selectie moet worden geoptimaliseerd om ervoor te zorgen dat deze voldoet aan alle geconfigureerde vereisten voor de kwaliteit van de verbinding. Dit kan omvatten het optimaliseren van roamscans, het optimaliseren van AP-selectie, het optimaliseren van het koppelingsproces en het minimaliseren van de benodigde beveiligingshanddruk. Als het apparaat tijdens een scan aanvullende koppelingsparameters nodig heeft voor een gevonden BSS-vermelding (bijvoorbeeld PMKID voor roaming), kan er een NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST indicatie worden verzonden om de parameters op te halen. Indien beschikbaar, configureert de host deze parameters met OID_WDI_SET_ASSOCIATION_PARAMETERS.

Als de verbinding mislukt of is afgebroken, moet de poort geen instellingen opnieuw instellen die mogelijk buiten de opdracht Verbinding maken zijn geconfigureerd. De host moet ondersteuning bieden voor het uitgeven van een tweede verbindingsoproep op dezelfde poort.

De status van de verbindingspoging voor elke BSS-vermelding moet worden gerapporteerd door de poort aan het einde van de koppelingspoging. Dit omvat de geslaagde poging en ook mislukte pogingen. Op elk gewenst moment moet de poort zijn gekoppeld aan niet meer dan één toegangspunt of Wi-Fi Direct GO.

Terwijl er verbinding wordt gemaakt, moet de poort alle verbindingen onderhouden die zijn ingesteld op andere poorten (bijvoorbeeld Infrastructuur of Wi-Fi Direct). De poort kan echter de hoeveelheid gemiddelde toegang tot de andere poorten verminderen om de verbinding te voltooien. Tijdens de verbinding kan de host verzendaanvragen voor pakketten verzenden op andere poorten.

Als voor het verificatie-algoritme dat wordt gebruikt voor de verbinding 802.1x poortautorisatie is vereist voor netwerktoegang, autoriseert de host de poort nadat de koppelingsbewerking is voltooid.

Het station 802.11 gebruikt de PMKID-cache voor pre-verificatie voor toegangspunten waarvoor het RSNA-verificatie-algoritme (Robust Security Network Association) is ingeschakeld. Als het station 802.11 wordt gekoppeld aan of opnieuw wordt gekoppeld aan een BSSID met een opgegeven PMKID, moet het station 802.11 de PMKID-gegevens gebruiken in het RSN-informatieelement (RSN IE) van het association- of reassociationframe.

Als de poort ondersteuning voor de fips-modus host in WIFI_STATION_CAPABILITIESdeclareert, kan HostFIPSModeEnabled- worden ingesteld op 1 in de verbindingsparameters.

Als HostFIPSModeEnabled- is ingesteld op 1, zijn de volgende regels van toepassing.

• De poort moet voldoen aan de richtlijnen voor het verzenden/ontvangen van gegevensframes in verzendbewerkingen in de FIPS-modus en ontvangstbewerkingen in de FIPS-modus.
• De poort mag geen ondersteuning declareren voor een QoS-protocol in de koppelingsaanvraag die naar een niet-HT-toegangspunt wordt verzonden. QoS-ondersteuning is vereist voor HT-verbindingen.
• De poort mag niet onderhandelen over TSpec en mag geen MSDU-aggregatie verzenden.
• De poort moet ervoor zorgen dat de SPP A-MSDU-compatibele bit (bit 10) van de RSN-mogelijkheden die worden verzonden, is ingesteld op nul. In deze modus wordt alleen PP A-MSDU ondersteund.

De verbindingsparameters mogen niet MFPEnabled- en HostFIPSModeEnabled beide zijn ingesteld op 1. Management Frame Protection (802.11w) vereist dat de poort bepaalde beheer- en actieframes versleutelt/ontsleutelt, zodat deze niet kan worden ingeschakeld voor een verbinding met de HOST FIPS-modus. Bovendien zijn Wake on Wireless LAN-functies niet van toepassing in Host-FIPS modus.

WiFi 7 / MLO vereisten

Windows biedt de instelling MloConnectionSupported in WDI_TLV_CONNECTION_SETTINGS die aangeeft of het stuurprogramma verbinding kan maken met behulp van MLO. Wanneer de verbinding met een beveiligd netwerk is ingesteld, kan het stuurprogramma alleen de AKM- en coderingsparen gebruiken die zijn opgegeven in WDI_TLV_RSNA_AKM_CIPHER_SUITE. De enige uitzondering is als de verificatie/codering geen deel uitmaakt van de RSNA IE.

Zie WiFiCx Wi-Fi 7 functievereistenvoor meer informatie.

Taakparameters

TLV	Meerdere TLV-exemplaren zijn toegestaan	Facultatief	Beschrijving
WDI_TLV_CONNECT_PARAMETERS			De verbindingsparameters.
WDI_TLV_CONNECT_BSS_ENTRY	X		De voorkeurslijst van kandidaat verbindt BSS-vermeldingen. De poort moet proberen verbinding te maken met een van deze BSS-vermeldingen totdat de lijst is uitgeput of de verbinding is voltooid. De poort kan de vermeldingen zo nodig opnieuw herpriritiseren. Als de adapter de bit voor het overschrijven van BSS-selectie verbinden heeft ingesteld, kan deze een BSS kiezen die niet in deze lijst staat zolang deze volgt op de lijst Toegestaan/Niet toegestaan.

Indicatie van voltooiing van taak

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Ongevraagde indicatie

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

Eisen

Eis	Waarde
Minimaal ondersteunde client	Windows 11
Minimaal ondersteunde server	Windows Server 2022
Rubriek	dot11wificxintf.h