DOT11EXTIHV_INIT_ADAPTER Rückruffunktion (wlanihv.h)

Artikel
02/27/2024

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 Dot11ExtIhvInitAdapter-Funktion auf, damit die DLL für IHV-Erweiterungen einen Adapterkontext ordnet und initialisiert.

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 DLL für IHV-Erweiterungen muss diesen Handle-Wert beim Aufrufen einer IHV-Erweiterbarkeitsfunktion verwenden, die einen hDot11SvcHandle-Parameter deklariert, z. B. Dot11ExtPreAssociateCompletion.

[out] phIhvExtAdapter

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

In der Regel ordnet die DLL für IHV-Erweiterungen ein Zustandsarray für den Adapterkontext zu und gibt die Adresse des Arrays als Handle-Wert zurück.

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

Weitere Informationen zur Initialisierung des WLAN-Adapters finden Sie unter 802.11 WLAN Adapter Arrival.

Anforderungen

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

Weitere Informationen

Native 802.11 IHV-Erweiterbarkeitsfunktionen

Dot11ExtPreAssociateCompletion Dot11ExtIhvPerformPreAssociate

DOT11_ADAPTER

Freigeben über