DOT11EXT_REQUEST_VIRTUAL_STATION Rückruffunktion (wlanihv.h)

Artikel
02/07/2025

Wichtige Die Native 802.11 Wireless LAN--Schnittstelle 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 IHV Extensions DLL ruft die Dot11ExtRequestVirtualStation Funktion auf, um anzufordern, dass das Betriebssystem eine virtuelle Station 802.11 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 (WLAN) zu verweisen. Dieser Handlewert wurde als hDot11SvcHandle Parameter über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion 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 fehlercode zurückgegeben, der in Winerror.h definiert ist.

Bemerkungen

Wenn diese Anforderungsfunktion erfolgreich abgeschlossen wird, beginnt das Betriebssystem, die Anforderung zum Erstellen einer virtuellen Station zu verarbeiten. Es ist möglich, dass das Betriebssystem die Dot11ExtIhvInitAdapter IHV-Handlerfunktion 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 IHV-Erweiterungs-DLL erwarten, dass ein Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion empfangen wird. In diesem Aufruf übergibt das Betriebssystem ein Handle an den neuen virtuellen Adapter über den hDot11SvcHandle Parameter.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 7 und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	wlanihv.h (inklusive Wlanihv.h)

Siehe auch

Dot11ExtReleaseVirtualStation

Dot11ExtIhvInitAdapter

Freigeben über