DOT11EXTIHV_INIT_SERVICE Rückruffunktion (wlanihv.h)

Wichtig 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-Treibermodell.

 

Das Betriebssystem ruft die Dot11ExtIhvInitService-Funktion auf, um die IHV-Erweiterungen-DLL sowie die API-Schnittstelle zwischen dem Betriebssystem und der DLL zu initialisieren.

Syntax

DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;

DWORD Dot11extihvInitService(
  [in]  DWORD dwVerNumUsed,
  [in]  PDOT11EXT_APIS pDot11ExtAPI,
        LPVOID pvReserved,
  [out] PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
)
{...}

Parameter

[in] dwVerNumUsed

Die vom Betriebssystem verwendete Schnittstellenversion. Der Wert dieses Parameters muss zwischen den Bereichen der Versionsnummern liegen, die im pDot11IHVVersionInfo-Parameter des Dot11ExtIhvGetVersionInfo IHV-Handlerfunktion.

[in] pDot11ExtAPI

Ein Zeiger auf eine DOT11EXT_APIS-Struktur , die die Adressen der IHV-Erweiterbarkeitsfunktionen enthält, die vom Betriebssystem unterstützt werden. Das Betriebssystem formatiert diesen Parameter mit den Funktionsadressen, bevor die Dot11ExtIhvInitService-Funktion aufgerufen wird.

pvReserved

Dieser Parameter ist für die Verwendung durch das Betriebssystem reserviert.

[out] pDot11IHVHandlers

Ein Zeiger auf eine DOT11EXT_IHV_HANDLERS-Struktur , die die Adressen der IHV-Handlerfunktionen enthält, die von der DLL für IHV-Erweiterungen unterstützt werden. Die DLL formatiert diesen Parameter mit den Funktionsadressen, bevor vom Aufruf der Dot11ExtIhvInitService-Funktion zurückgegeben wird.

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

Das Betriebssystem ruft die Dot11ExtIhvInitService-Funktion unmittelbar nach dem Aufruf des Dot11ExtIhvGetVersionInfo-Funktion . Beim Aufruf muss Dot11ExtIhvInitService die IHV-Erweiterungen-DLL bei Bedarf initialisieren. Wenn die Funktion zurückgibt, muss die DLL vorbereitet sein, um zusätzliche Aufrufe der IHV-Handlerfunktion zu akzeptieren.

Im Gegensatz zur Behandlung anderer IHV-Erweiterungs- und Handlerfunktionen, deren Adressen über den pDot11IHVHandlers-Parameter aufgelöst werden, löst das Betriebssystem die Adresse der Dot11ExtIhvInitService-Funktion auf, indem die GetProcAddress-Funktion aufgerufen wird. Daher muss der Entwickler der IHV-Erweiterungen-DLL diese Richtlinien befolgen.

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

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (include Wlanihv.h)

Weitere Informationen

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo