fonction de rappel DOT11EXTIHV_INIT_VIRTUAL_STATION (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 Dot11ExtIhvInitVirtualStation pour initialiser la DLL des extensions IHV pour les opérations de station virtuelle et pour initialiser l’interface API entre le système d’exploitation et la DLL.

Syntaxe

DOT11EXTIHV_INIT_VIRTUAL_STATION Dot11extihvInitVirtualStation;

DWORD Dot11extihvInitVirtualStation(
  [in] PDOT11EXT_VIRTUAL_STATION_APIS pDot11ExtVSAPI,
       LPVOID pvReserved
)
{...}

Paramètres

[in] pDot11ExtVSAPI

Pointeur vers un DOT11EXT_VIRTUAL_STATION_APIS structure qui contient les adresses des fonctions de station virtuelle d’extensibilité IHV prises en charge par le système d’exploitation. Le système d’exploitation met en forme ce paramètre avec les adresses de fonction avant d’effectuer un appel à la fonction Dot11ExtIhvInitVirtualStation.

pvReserved

Ce paramètre est réservé pour être utilisé par le système d’exploitation et doit être NULL.

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

Il est facultatif que la DLL des extensions IHV implémente et exporte cette fonction.

Le système d’exploitation appelle la fonction Dot11ExtIhvInitVirtualStation immédiatement après qu’elle appelle la fonction Dot11ExtIhvInitService, mais avant d’appeler la fonction Dot11ExtIhvInitAdapter fonction.

En réponse à un appel à Dot11ExtIhvInitVirtualStation, la DLL extensions IHV peut initialiser ses structures de données internes avec les informations fournies à partir de l’appel de fonction Dot11ExtIhvInitService.

Remarque La DLL extensions IHV est autorisée à appeler les fonctions d’API de station virtuelle que le paramètre pDot11ExtVSAPI pointe uniquement après que la fonction Dot11ExtIhvInitVirtualStation retourne.

 

Le système d’exploitation résout l’adresse de la fonction Dot11ExtIhvInitVirtualStation en appelant la fonction GetProcAddress. Par conséquent, le développeur de la DLL des extensions IHV doit suivre ces instructions si cette fonction est implémentée.

• La DLL doit implémenter une fonction nommée Dot11ExtIhvInitVirtualStation, qui a le format décrit dans cette rubrique.
• L’instruction EXPORTS du fichier source de définition de module (.def), utilisée pour générer la DLL d’extensions IHV, doit contenir une entrée de nom de fonction pour la fonction Dot11ExtIhvInitVirtualStation.

Pour plus d’informations sur GetProcAddress, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Windows.

Exigences

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

Voir aussi

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo