DOT11EXT_SEND_UI_REQUEST Rückruffunktion (wlanihv.h)

  • Artikel
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.
 
Die IHV-Erweiterungen-DLL ruft die Dot11ExtSendUIRequest-Funktion auf, um Benutzerbenachrichtigungen oder Eingaben über die NATIVE 802.11 IHV UI Extensions DLL anzufordern.

Syntax

DOT11EXT_SEND_UI_REQUEST Dot11extSendUiRequest;

DWORD Dot11extSendUiRequest(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11EXT_IHV_UI_REQUEST pIhvUIRequest
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Das Handle, das vom Betriebssystem verwendet wird, um auf den WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handle-Wert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] pIhvUIRequest

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, formatiert als DOT11EXT_IHV_UI_REQUEST Struktur.

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 muss diese Richtlinien beim Aufrufen der Funktion Dot11ExtSendUIRequest befolgen.

  • Anforderungen für Ereignisbenachrichtigungen durch die Native 802.11 IHV UI Extensions DLL werden durch einen Aufruf des Dot11ExtIhvProcessUIResponse IHV-Handlerfunktion. Die DLL für IHV-Erweiterungen darf den Speicher, auf den der Parameter pIhvUIRequest verweist, erst freigeben, wenn die Anforderung abgeschlossen ist.
  • Wenn das Betriebssystem die IHV-Handlerfunktionen Dot11ExtIhvAdapterReset oder Dot11ExtIhvDeinitAdapter aufruft , kann die IHV-Erweiterungen-DLL davon ausgehen, dass die UI-Anforderung abgebrochen wurde. In diesem Fall muss die DLL den Arbeitsspeicher freigeben, auf den der pIhvUIRequest-Parameter verweist.
  • Das Betriebssystem kann die Vervollständigung status der Anforderung über einen Aufruf des Dot11ExtIhvIsUIRequestPending IHV-Handlerfunktion.

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

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvProcessUIResponse

Dot11ExtIhvInitAdapter

Dot11ExtIhvIsUIRequestPending