DOT11EXTIHV_INIT_ADAPTER 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 Dot11ExtIhvInitAdapter Funktion auf, damit die IHV Extensions DLL einen Adapterkontext zuordnen und initialisieren kann.

Syntax

DOT11EXTIHV_INIT_ADAPTER Dot11extihvInitAdapter;

DWORD Dot11extihvInitAdapter(
  [in]           PDOT11_ADAPTER pDot11Adapter,
  [in, optional] HANDLE hDot11SvcHandle,
  [out]          PHANDLE phIhvExtAdapter
)
{...}

Parameter

[in] pDot11Adapter

Ein Zeiger auf eine DOT11_ADAPTER-Struktur, die den zu initialisierenden Adapter identifiziert.

[in, optional] hDot11SvcHandle

Ein Handle, das vom Betriebssystem für den Adapter zugewiesen wird. Die IHV-Erweiterungs-DLL muss diesen Handle-Wert verwenden, wenn eine IHV-Erweiterbarkeitsfunktion aufgerufen wird, die einen hDot11SvcHandle--Parameter deklariert, z. B. Dot11ExtPreAssociateCompletion.

[out] phIhvExtAdapter

Ein Zeiger auf eine Handlevariable. Die IHV Extensions DLL muss einen eindeutigen Handle-Wert für den Adapter zuweisen und * phIhvExtAdapter auf den Handlewert festlegen. Das Betriebssystem verwendet diesen Handle-Wert, wenn er eine IHV-Handlerfunktion aufruft, die einen hIhvExtAdapter Parameter deklariert, z. B. Dot11ExtIhvPerformPreAssociate.

In der Regel weist die IHV Extensions DLL ein Statusarray für den Adapterkontext zu und gibt die Adresse des Arrays als Handlewert zurück.

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 Dot11ExtIhvInitAdapter Funktion auf, wenn ein WLAN-Adapter verfügbar und zur Verwendung aktiviert wird, z. B. wenn ein PCMCIA-Adapter eingefügt wird.

Weitere Informationen zur WLAN-Adapterinitialisierung finden Sie unter 802.11 WLAN Adapter Arrival.

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

Native 802.11 IHV Erweiterbarkeitsfunktionen

Dot11ExtPreAssociateCompletion Dot11ExtIhvPerformPreAssociate

DOT11_ADAPTER

Freigeben über