fonction de rappel DOT11EXTIHV_INIT_ADAPTER (wlanihv.h)

Article
02/27/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 Dot11ExtIhvInitAdapter pour que la DLL des extensions IHV alloue et initialise un contexte d’adaptateur.

Syntaxe

DOT11EXTIHV_INIT_ADAPTER Dot11extihvInitAdapter;

DWORD Dot11extihvInitAdapter(
  [in]           PDOT11_ADAPTER pDot11Adapter,
  [in, optional] HANDLE hDot11SvcHandle,
  [out]          PHANDLE phIhvExtAdapter
)
{...}

Paramètres

[in] pDot11Adapter

Pointeur vers une structure DOT11_ADAPTER , qui identifie l’adaptateur à initialiser.

[in, optional] hDot11SvcHandle

Handle attribué par le système d’exploitation pour l’adaptateur. La DLL des extensions IHV doit utiliser cette valeur de handle lors de l’appel d’une fonction d’extensibilité IHV qui déclare un paramètre hDot11SvcHandle , tel que Dot11ExtPreAssociateCompletion.

[out] phIhvExtAdapter

Pointeur vers une variable de handle. La DLL des extensions IHV doit affecter une valeur de handle unique pour l’adaptateur et définir * phIhvExtAdapter sur la valeur de handle. Le système d’exploitation utilise cette valeur de handle lorsqu’il appelle une fonction de gestionnaire IHV qui déclare un paramètre hIhvExtAdapter , tel que Dot11ExtIhvPerformPreAssociate.

En règle générale, la DLL des extensions IHV alloue un tableau d’états pour le contexte de l’adaptateur et retourne l’adresse du tableau en tant que valeur de handle.

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

Le système d’exploitation appelle la fonction Dot11ExtIhvInitAdapter chaque fois qu’une carte WLAN devient disponible et activée pour une utilisation, par exemple lorsqu’une carte PCMCIA est insérée.

Pour plus d’informations sur l’initialisation de l’adaptateur WLAN, consultez Arrivée de l’adaptateur WLAN 802.11.

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

Fonctions d’extensibilité IHV natives 802.11

Dot11ExtPreAssociateCompletion Dot11ExtIhvPerformPreAssociate

DOT11_ADAPTER

Partager via