DOT11EXTIHV_QUERY_UI_REQUEST fonction de rappel (wlanihv.h)

Article
03/01/2024

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

Le système d’exploitation appelle la fonction Dot11ExtIhvQueryUIRequest chaque fois que la connexion status change. Lorsque cette fonction est appelée, la DLL des 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 des extensions IHV pour référencer l’adaptateur LAN sans fil (WLAN). Cette valeur de handle a été spécifiée lors d’un appel précédent à la fonction 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 n’importe quelle 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 que la DLL des extensions IHV a terminé 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 retournée

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

Remarques

Lorsque Dot11ExtIhvQueryUIRequest est appelé, la DLL des extensions IHV doit allouer et renvoyer une mémoire tampon mise en forme en tant que 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 à partir de Dot11ExtIhvQueryUIRequest, le système d’exploitation est chargé d’appeler Dot11ExtFreeBuffer pour libérer la mémoire tampon.
La DLL des extensions IHV met en forme la structure DOT11EXT_IHV_UI_REQUEST pour une demande d’interface utilisateur appropriée pour la modification de la status de connexion.
Par exemple, si connectionPhase a la valeur connection_phase_initial_connection, la DLL des extensions IHV peut définir les membres de la structure DOT11EXT_IHV_UI_REQUEST pour référencer une page d’interface utilisateur qui avertit l’utilisateur du début de l’opération de connexion.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wlanihv.h (inclure Wlanihv.h)