OID_WDI_TASK_SCAN (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_SCAN vraagt om een enquête van BSS-netwerken. De poort voert een scan uit volgens de vereisten van de IEEE 802.11-specificatie.

Object	Afgebroken geschikt	Standaardprioriteit (hoststuurprogrammabeleid)	Normale uitvoeringstijd (seconden)
Haven	Ja. De poort moet na het afbreken in een schone toestand zijn.	6 (achtergrondscan) 5 (door de gebruiker geïnitieerde scan)	4

Een taak die een WDI_TLV_STATUS bevat, wordt aangegeven wanneer de poort de scan heeft gestart en klaar is om andere opdrachten te ontvangen.

Zodra een scan is gestart wanneer deze is ingeschakeld door LiveUpdatesNeeded, moet de poort incrementele updates (met ongevraagde indicaties van NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST) over gedetecteerde BSS-vermeldingen verstrekken. BSS-vermeldingen die eerder waren gedetecteerd, maar die niet zijn gevonden door de poort in de huidige scan, mogen niet door de poort worden gerapporteerd. Om energie- en prestatieredenen moet de poort indicaties beperken en updates alleen verzenden naar de host wanneer deze 3 of meer heeft gedetecteerd, of wanneer deze minder dan 3 vermeldingen heeft gedetecteerd, maar deze gedurende meer dan 500 milliseconden niet aan de host heeft gerapporteerd. Nadat de scan is voltooid, hoeft de BSS-vermeldingen die zijn gedetecteerd niet door de adapter te worden beheerd, niet meer nodig om de BSS-vermeldingen te onthouden die zijn gedetecteerd. Zodra de scanbewerking is voltooid, moet de poort de melding dat de taak is voltooid naar het besturingssysteem verzenden en stoppen met het rapporteren van BSS-vermeldingen aan de host. De scanopdracht wordt gebruikt voor het vinden van verouderde (niet-Wi-Fi Directe netwerken) en de poort mag niet de Wi-Fi Directe IE's in de testaanvragen bevatten.

Als de adapter BSS-vermeldingen niet beheert, onthoudt de host de BSS-vermeldingen die door de poort zijn gerapporteerd na een scan gedurende een bepaalde periode. Er treedt een time-out op van de vermeldingen in de cache en wordt deze leeggemaakt. Als de adapter de BSS-vermeldingen beheert, wordt deze in de cache opgeslagen en wordt er een time-out opgetreden. De host kan de OID_WDI_SET_FLUSH_BSS_ENTRY opdracht verzenden om de vermeldingen expliciet leeg te maken.

De host houdt BSS-vermeldingen bij met behulp van hun BSSID. Als de poort twee BSS-vermeldingen voor dezelfde BSSID rapporteert, overschrijft de host de ene met de andere.

Terwijl de scan wordt uitgevoerd, moet de poort de bestaande verbindingen onderhouden (bijvoorbeeld Infrastructuur of Wi-Fi Direct). Als er al verbindingen bestaan, moet de poort een subset van kanalen tegelijk scannen en tussen subsets de andere verbindingen toegang geven tot het medium. Tijdens de scan kan de host pakketaanvragen verzenden naar elke poort op de adapter.

In de aangegeven BSS-vermeldingen kan de poort apparaatspecifieke contextinformatie bevatten. Deze contextinformatie wordt teruggegeven aan het apparaat als de poort wordt gevraagd verbinding te maken met die BSS-vermelding. Deze context kan echter automatisch door de host worden gewist als de BSS-vermelding wordt leeggemaakt.

De scanopdracht kan worden afgebroken. Wanneer de opdracht wordt afgebroken, moet de poort stoppen met het zoeken naar nieuwe BSS-netwerken en de scantaak zo snel mogelijk voltooien. Wanneer de taak is voltooid (normaal of vanwege een afgebroken taak), moet de poort een goede status hebben, zodat een andere scan op die poort kan worden uitgegeven.

De adapter mag geen wettelijke beperkingen schenden bij het uitvoeren van een scan.

Taakparameters

TLV	Meerdere TLV-exemplaren zijn toegestaan	Facultatief	Beschrijving
WDI_TLV_BSSID		X	BSSID van het netwerk dat moet worden gescand. Als dit het broadcast MAC-adres is, scant het station op alle BSSID's.
WDI_TLV_SSID	X	X	Een lijst met SSID-lijst waarop de poort moet scannen. Er kunnen meerdere SSID's in deze lijst staan en een van deze SSID's kan een jokerteken zijn. Wanneer u een actieve scan uitvoert op een kanaal, moet de poort een testaanvraag verzenden voor elke SSID in de lijst. Als deze lijst leeg is, moet de poort scannen op alle SSID's.
WDI_TLV_BAND_CHANNEL	X	X	Een lijst met aanbevolen kanalen die moeten worden gescand. De adapter kan een scan uitvoeren op een subset of superset van de kanaallijst zolang deze voldoet aan de vereisten voor maximale scantijd. Als deze lijst leeg is, moet de poort scannen op alle ondersteunde kanalen.
WDI_TLV_VENDOR_SPECIFIC_IE		X	Een of meer IE's die moeten worden opgenomen in de testaanvragen die door de poort worden verzonden. Deze IE's worden niet gebruikt voor passieve scan.
WDI_TLV_SCAN_MODE			Parameters voor scanmodus.
WDI_TLV_SCAN_DWELL_TIME			Parameters van de woningtijd.
WDI_TLV_6_GHZ_BAND_CHANNEL		X	Lijst met kanalen die worden aanbevolen om te scannen in de 6 GHz-band. Wanneer deze is opgegeven, kan de adapter een scan uitvoeren op een subset of superset van de kanaallijst zolang deze voldoet aan de vereisten voor maximale scantijd.

Indicatie van voltooiing van taak

NDIS_STATUS_WDI_INDICATION_SCAN_COMPLETE

Ongevraagde indicatie

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

Deze melding wordt door het apparaat gebruikt om de host te vertellen over updates van de BSS-vermeldingen. Het kan op elk gewenst moment worden verzonden.

Eisen

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