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 |