Freigeben über


OID_WDI_TASK_START_AP

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_START_AP fordert an, dass die IHV-Komponente einen Port konfiguriert, um einen Wi-Fi direkten Gruppenbesitzer auf dem angegebenen Port zu starten.

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

Während der Initialisierung legt der Treiber die Go on 5GHz-Bandfunktion in WDI_TLV_P2P_CAPABILITIES fest, um anzugeben, ob er den Zugriffspunkt im 5-GHz-Band starten kann.

Wenn GO on 5 GHz-Bandunterstützung festgelegt ist, sollte der Adapter den AP auf dem angekündigten Betriebskanal starten, und wenn dies fehlschlägt, sollte er die liste ausprobieren, die im Parameter "AP-Bandkanalliste" angegeben ist. Das Betriebssystem gibt dem Treiber einen Hinweis, ob dieser AP Internetkonnektivität bereitstellt, indem das DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED-Flag in WDI_TLV_P2P_GROUP_OWNER_CAPABILITY festgelegt wird.

Wenn MustUseSpecifiedChannel in WDI_TLV_START_AP_PARAMETERS angegeben ist, gibt der AP möglicherweise einen der folgenden Fehler zurück, wenn er nicht in der Lage ist, den AP auf den angegebenen Band/Kanälen zu starten.

NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE: Der AP kann derzeit nicht auf den angegebenen Kanälen gestartet werden. Wiederholen Sie es später mit den angegebenen Kanälen.

NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE: Der AP kann derzeit nicht auf den angegebenen Banden gestartet werden. Wiederholen Sie es später mit den angegebenen Banden.

NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED: Der AP kann aus regulatorischen Gründen nicht auf den angegebenen Kanälen gestartet werden.

NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED: Der AP kann aus regulatorischen Gründen nicht auf den angegebenen Banden gestartet werden.

Aufgabenparameter

TLV Mehrere TLV-Instanzen zulässig Optional BESCHREIBUNG
WDI_TLV_SSID Die vom AP zu verwendende SSID.
WDI_TLV_START_AP_PARAMETERS Zusätzliche Parameter für diese Aufgabe.
WDI_TLV_AUTH_ALGO_LIST Die Liste der Authentifizierungsalgorithmen, die die Verbindung verwenden kann.
WDI_TLV_MULTICAST_CIPHER_ALGO_LIST Die Liste der Multicastverschlüsselungsalgorithmen, die die Verbindung verwenden kann.
WDI_TLV_UNICAST_CIPHER_ALGO_LIST Die Liste der Multicastverschlüsselungsalgorithmen, die die Verbindung verwenden kann.
WDI_TLV_P2P_CHANNEL_NUMBER X Wenn angegeben, definiert dies den in der Gruppenbildung ermittelten Betriebskanal. Dies kann nur angegeben werden, wenn der Betriebsmodus Wi-Fi Direct GO ist.
WDI_TLV_AP_BAND_CHANNEL X X Hinzugefügt in Windows 10 Version 1511, WDI Version 1.0.10.

Optionale Liste von Bändern und Kanälen zum Starten des Zugriffspunkts. Wenn MustUseSpecifiedChannels auf 1 festgelegt ist, kann der AP nur über diese Liste gestartet werden. Wenn sie nicht festgelegt ist, soll diese Liste eine Empfehlung von Kanälen sein, von denen die Firmware auswählen kann, und sie kann einen anderen Kanal auswählen, wenn es nicht möglich ist, den AP auf einem der angegebenen Kanäle zu starten.

Vorgangsabschlussanzeige

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Anforderungen

Unterstützte Mindestversion (Client)

Windows 10

Unterstützte Mindestversion (Server)

Windows Server 2016

Header

Dot11wdi.h