DOT11EXTIHV_INIT_VIRTUAL_STATION Rückruffunktion (wlanihv.h)

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.

 

Das Betriebssystem ruft die Dot11ExtIhvInitVirtualStation Funktion auf, um die IHV Extensions DLL für virtuelle Station-Vorgänge zu initialisieren und die API-Schnittstelle zwischen dem Betriebssystem und der DLL zu initialisieren.

Syntax

DOT11EXTIHV_INIT_VIRTUAL_STATION Dot11extihvInitVirtualStation;

DWORD Dot11extihvInitVirtualStation(
  [in] PDOT11EXT_VIRTUAL_STATION_APIS pDot11ExtVSAPI,
       LPVOID pvReserved
)
{...}

Parameter

[in] pDot11ExtVSAPI

Ein Zeiger auf ein DOT11EXT_VIRTUAL_STATION_APIS Struktur, die die Adressen der virtuellen IHV-Erweiterungsfunktionen enthält, die vom Betriebssystem unterstützt werden. Das Betriebssystem formatiert diesen Parameter mit den Funktionsadressen, bevor ein Aufruf der Dot11ExtIhvInitVirtualStation-Funktion ausgeführt wird.

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

Sie ist optional für die IHV-Erweiterungs-DLL, um diese Funktion zu implementieren und zu exportieren.

Das Betriebssystem ruft die Dot11ExtIhvInitVirtualStation Funktion unmittelbar nach dem Aufruf der Dot11ExtIhvInitService--Funktion auf, aber bevor sie die Funktion aufruft Dot11ExtIhvInitAdapter Funktion.

Als Reaktion auf einen Aufruf von Dot11ExtIhvInitVirtualStationkann die IHV Extensions DLL ihre internen Datenstrukturen mit den Informationen aus dem Dot11ExtIhvInitService Funktionsaufruf initialisieren.

Hinweis Die IHV-Erweiterungs-DLL darf die Funktionen der virtuellen Station-API aufrufen, auf die die pDot11ExtVSAPI Parameter verweist, nur nachdem die Dot11ExtIhvInitVirtualStation Funktion zurückgegeben wird.

 

Das Betriebssystem löst die Adresse der Dot11ExtIhvInitVirtualStation--Funktion auf, indem die GetProcAddress-funktion aufgerufen wird. Daher muss der Entwickler der IHV Extensions DLL diese Richtlinien befolgen, wenn diese Funktion implementiert wird.

• Die DLL muss eine Funktion namens Dot11ExtIhvInitVirtualStation implementieren, die das in diesem Thema beschriebene Format aufweist.
• Die EXPORTS-Anweisung der Quellmoduldefinitionsdatei (DEF), die zum Erstellen der IHV Extensions DLL verwendet wird, muss einen Funktionsnameneintrag für die Dot11ExtIhvInitVirtualStation-Funktion enthalten.

Weitere Informationen zu GetProcAddressfinden Sie in der Microsoft Windows SDK-Dokumentation.

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

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo