DOT11EXTIHV_INIT_SERVICE 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.

Das Betriebssystem ruft die Dot11ExtIhvInitService Funktion auf, um die IHV Extensions 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 in der pDot11IHVVersionInfo Parameter des Parameters "pDot11IHVVersionInfo" zurückgegebenen Versionsnummern liegen. 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 der Aufruf der Dot11ExtIhvInitService Funktion ausgeführt 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 IHV Extensions DLL unterstützt werden. Die DLL formatiert diesen Parameter mit den Funktionsadressen, bevor der Aufruf an die Dot11ExtIhvInitService Funktion zurückgegeben wird.

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

Das Betriebssystem ruft die funktion Dot11ExtIhvInitService unmittelbar nach dem Aufruf des Aufrufs des Dot11ExtIhvGetVersionInfo Funktion. Bei Aufruf muss Dot11ExtIhvInitService die IHV-Erweiterungs-DLL bei Bedarf initialisieren. Wenn die Funktion zurückgegeben wird, muss die DLL bereit sein, zusätzliche Aufrufe der IHV-Handlerfunktion anzunehmen.

Im Gegensatz zur Behandlung anderer IHV-Erweiterungs- und Handlerfunktionen, deren Adressen über die 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 Extensions 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 Extensions DLL verwendet wird, muss einen Funktionsnameneintrag für die Dot11ExtIhvInitService--Funktion enthalten.

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

Anforderungen

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

Siehe auch

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo

Freigeben über