fonction de rappel DOT11EXTIHV_PROCESS_UI_RESPONSE (wlanihv.h)

Article
08/08/2023

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 Dot11ExtIhvProcessUIResponse pour effectuer une demande d’interface utilisateur initiée par la DLL des extensions IHV via un appel à Dot11ExtSendUIRequest.

Syntaxe

DOT11EXTIHV_PROCESS_UI_RESPONSE Dot11extihvProcessUiResponse;

DWORD Dot11extihvProcessUiResponse(
  [in]           GUID guidUIRequest,
  [in]           DWORD dwByteCount,
  [in, optional] LPVOID pvResponseBuffer
)
{...}

Paramètres

[in] guidUIRequest

GUID qui identifie la demande. Cette valeur GUID a été créée par la DLL des extensions IHV et transmise via le paramètre pIhvUIRequest de l’appel à Dot11ExtSendUIRequest.

[in] dwByteCount

Longueur, en octets, des données référencées via le paramètre pvResponseBuffer .

[in, optional] pvResponseBuffer

Pointeur vers la mémoire tampon qui contient les données utilisateur.

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

La DLL des extensions IHV peut émettre des demandes à la DLL des extensions d’interface utilisateur IHV pour une interaction avec l’utilisateur, par exemple l’affichage des notifications pendant l’opération de pré-association ou l’entrée d’informations d’identification pour l’opération post-association. Pour plus d’informations sur la DLL des extensions d’interface utilisateur IHV, consultez DLL Native 802.11 IHV UI Extensions.

La DLL des extensions IHV lance ces demandes d’interaction utilisateur par le biais d’appels à la fonction Dot11ExtSendUIRequest . Pour chaque requête d’interface utilisateur, la DLL doit mettre en forme une structure DOT11EXT_IHV_UI_REQUEST pour définir la demande et doit définir le membre guidUIRequest de cette structure sur une valeur GUID qui identifie de manière unique la demande d’interface utilisateur. La DLL transmet l’adresse de la structure DOT11EXT_IHV_UI_REQUEST via le paramètre pIhvUIRequest de la fonction Dot11ExtSendUIRequest .

Après avoir reçu ces données de la DLL des extensions IHV, le système d’exploitation appelle la fonction Dot11ExtIhvProcessUIResponse pour traiter la réponse de l’utilisateur, qui est référencée via le paramètre pvResponseBuffer . Les données de réponse sont dans un format défini par l’IHV et ont été validées par la DLL des extensions de l’interface utilisateur IHV.

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)

Voir aussi

DOT11EXT_IHV_UI_REQUEST

Dot11ExtSendUIRequest

Partager via