DOT11EXT_REQUEST_VIRTUAL_STATION Rückruffunktion (wlanihv.h)

Artikel
03/05/2024

Wichtig Die native WLAN-Schnittstelle 802.11 ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows driver model.

Die DLL für IHV-Erweiterungen ruft die Dot11ExtRequestVirtualStation-Funktion auf, um anzufordern, dass das Betriebssystem eine virtuelle 802.11-Station erstellt.

Syntax

DOT11EXT_REQUEST_VIRTUAL_STATION Dot11extRequestVirtualStation;

DWORD Dot11extRequestVirtualStation(
  [in, optional] HANDLE hDot11PrimaryHandle,
                 LPVOID pvReserved
)
{...}

Parameter

[in, optional] hDot11PrimaryHandle

Ein Handle, das vom Betriebssystem verwendet wird, um auf den primären physischen WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde als hDot11SvcHandle-Parameter durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter empfangen.

pvReserved

Dieser Parameter ist für die Verwendung durch das Betriebssystem reserviert und sollte NULL sein.

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Wenn diese Anforderungsfunktion erfolgreich abgeschlossen wurde, beginnt das Betriebssystem mit der Verarbeitung der Anforderung zum Erstellen einer virtuellen Station. Es ist möglich, dass das Betriebssystem die IHV-Handlerfunktion Dot11ExtIhvInitAdapter aufruft , um die virtuelle Station vor oder nach dem Aufruf von Dot11ExtRequestVirtualStation zu initialisieren.

Nachdem das Betriebssystem die neue virtuelle Station erstellt hat, sollte die DLL für IHV-Erweiterungen einen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter erwarten. In diesem Aufruf übergibt das Betriebssystem ein Handle über den hDot11SvcHandle-Parameter an den neuen virtuellen Adapter.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (wlanihv.h einschließen)

Weitere Informationen

Dot11ExtReleaseVirtualStation

Dot11ExtIhvInitAdapter

Freigeben über