Freigeben über


DOT11EXT_SEND_UI_REQUEST Rückruffunktion (wlanihv.h)

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.
 
Die IHV Extensions DLL ruft die Dot11ExtSendUIRequest Funktion auf, um benutzerbenachrichtigungen oder Eingaben über die Native 802.11 IHV UI Extensions DLLanzufordern.

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 Handlewert wurde über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion 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 fehlercode zurückgegeben, der in Winerror.h definiert ist.

Bemerkungen

Die IHV Extensions DLL muss diese Richtlinien beim Aufrufen der Dot11ExtSendUIRequest-Funktion befolgen.

  • Anforderungen für die Ereignisbenachrichtigung durch die Native 802.11 IHV UI Extensions DLL- werden über einen Aufruf des Dot11ExtIhvProcessUIResponse IHV-Handlerfunktion. Die IHV Extensions DLL darf den Speicher, auf den die pIhvUIRequest Parameter verweist, nicht freigeben, bis die Anforderung abgeschlossen ist.
  • Wenn das Betriebssystem die Dot11ExtIhvAdapterReset oder Dot11ExtIhvDeinitAdapter IHV-Handlerfunktionen aufruft, kann die IHV Extensions DLL davon ausgehen, dass die UI-Anforderung abgebrochen wurde. In diesem Fall muss die DLL den Speicher freigeben, auf den vom pIhvUIRequest Parameter verwiesen wird.
  • Das Betriebssystem kann den Abschlussstatus der Anforderung über einen Aufruf des Dot11ExtIhvIsUIRequestPending IHV Handler-Funktion.

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

Dot11ExtIhvAdapterReset-

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvProcessUIResponse

Dot11ExtIhvInitAdapter

Dot11ExtIhvIsUIRequestPending