DOT11EXTIHV_INIT_VIRTUAL_STATION Rückruffunktion (wlanihv.h)

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.

 

Das Betriebssystem ruft die Dot11ExtIhvInitVirtualStation-Funktion auf, um die DLL für IHV-Erweiterungen für vorgänge virtueller Stationen 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 eine DOT11EXT_VIRTUAL_STATION_APIS-Struktur , die die Adressen der funktionen der virtuellen IHV-Erweiterbarkeitsstation enthält, die vom Betriebssystem unterstützt werden. Das Betriebssystem formatiert diesen Parameter mit den Funktionsadressen, bevor die Dot11ExtIhvInitVirtualStation-Funktion aufgerufen 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 in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Die DLL für IHV-Erweiterungen kann diese Funktion implementieren und exportieren.

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

Als Reaktion auf einen Aufruf von Dot11ExtIhvInitVirtualStation kann die DLL für IHV-Erweiterungen ihre internen Datenstrukturen mit den Informationen initialisieren, die aus dem Dot11ExtIhvInitService-Funktionsaufruf bereitgestellt werden.

Hinweis Die DLL für IHV-Erweiterungen darf die API-Funktionen der virtuellen Station aufrufen, auf die der pDot11ExtVSAPI-Parameter verweist, nachdem die Dot11ExtIhvInitVirtualStation-Funktion zurückgegeben wurde.

 

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

• 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 DLL für IHV-Erweiterungen verwendet wird, muss einen Funktionsnameneintrag für die Dot11ExtIhvInitVirtualStation-Funktion enthalten.

Weitere Informationen zu GetProcAddress finden Sie in der dokumentation zu Microsoft Windows SDK.

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

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo