fonction de rappel DOT11EXTIHV_INIT_ADAPTER (wlanihv.h)

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 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 affecté par le système d’exploitation de l’adaptateur. La DLL d’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 d’extensions IHV doit affecter une valeur de handle unique pour l’adaptateur et définir * phIhvExtAdapter à 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 d’extensions IHV alloue un tableau d’état pour le contexte de l’adaptateur et retourne l’adresse du tableau comme valeur de handle.

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

Le système d’exploitation appelle la fonction Dot11ExtIhvInitAdapter chaque fois qu’un adaptateur WLAN devient disponible et activé 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 802.11 Arrivée de l’adaptateur WLAN.

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)

Voir aussi

fonctions d’extensibilité IHV natives 802.11

Dot11ExtPreAssociateCompletion Dot11ExtIhvPerformPreAssociate

DOT11_ADAPTER