DOT11EXTIHV_QUERY_UI_REQUEST fonction de rappel (wlanihv.h)

Article
02/07/2025

important l’interface Native 802.11 Wireless LAN est déconseillée dans Windows 10 et versions ultérieures. Utilisez à la place l’interface WDI (Device Driver Interface) DU RÉSEAU LOCAL. Pour plus d’informations sur WDI, consultez modèle de pilote Windows universel LOCAL.

Le système d’exploitation appelle la fonction Dot11ExtIhvQueryUIRequest chaque fois que l’état de la connexion change. Lorsque cette fonction est appelée, la DLL extensions IHV retourne une structure DOT11EXT_IHV_UI_REQUEST que le système d’exploitation peut utiliser pour une demande d’interface utilisateur.

Syntaxe

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

Paramètres

[in, optional] hIhvExtAdapter

Handle utilisé par la DLL d’extensions IHV pour référencer l’adaptateur LAN sans fil (WLAN). Cette valeur de handle a été spécifiée via un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter.

[in] connectionPhase

Phase de connexion actuelle. Le type de données de ce membre est l’énumération DOT11EXT_IHV_CONNECTION_PHASE :

connection_phase_any

Spécifie toute phase de connexion.

connection_phase_initial_connection

Spécifie la phase de connexion avant que la DLL des extensions IHV lance une opération de pré-association. Pour plus d’informations sur l’opération de pré-association, consultez opérations de pré-association.

connection_phase_post_l3_connection

Spécifie la phase de connexion une fois la DLL d’extensions IHV terminée une opération post-association. Pour plus d’informations sur l’opération post-association, consultez opérations post-association.

[out] ppIhvUIRequest

Adresse d’un pointeur vers une structure DOT11EXT_IHV_UI_REQUEST. La DLL des extensions IHV doit allouer une mémoire tampon pour la structure DOT11EXT_IHV_UI_REQUEST en appelant Dot11ExtAllocateBuffer.

Valeur de retour

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, elle retourne un code d’erreur défini dans Winerror.h.

Remarques

Quand Dot11ExtIhvQueryUIRequest est appelée, la DLL d’extensions IHV doit allouer et retourner une mémoire tampon mise en forme sous forme de structure DOT11EXT_IHV_UI_REQUEST. Dans ce cas, la DLL doit suivre les instructions suivantes :

La DLL des extensions IHV doit appeler Dot11ExtAllocateBuffer pour allouer la mémoire tampon. Une fois la DLL retournée par Dot11ExtIhvQueryUIRequest, le système d’exploitation est chargé d’appeler Dot11ExtFreeBuffer pour libérer la mémoire tampon.
La DLL extensions IHV met en forme la structure DOT11EXT_IHV_UI_REQUEST pour une demande d’interface utilisateur appropriée pour le changement d’état de connexion.
Par exemple, si connexionPhase est définie sur connection_phase_initial_connection, la DLL extensions IHV peut définir les membres de la structure DOT11EXT_IHV_UI_REQUEST pour référencer une page d’interface utilisateur qui informe l’utilisateur du début de l’opération de connexion.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	wlanihv.h (include Wlanihv.h)