DOT11EXTIHV_INIT_SERVICE fonction de rappel (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 l’interface WDI (Wlan Device Driver Interface) à la place. Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

Le système d’exploitation appelle la fonction Dot11ExtIhvInitService pour initialiser la DLL des extensions IHV ainsi que l’interface API entre le système d’exploitation et la DLL.

Syntaxe

DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;

DWORD Dot11extihvInitService(
  [in]  DWORD dwVerNumUsed,
  [in]  PDOT11EXT_APIS pDot11ExtAPI,
        LPVOID pvReserved,
  [out] PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
)
{...}

Paramètres

[in] dwVerNumUsed

Version de l’interface utilisée par le système d’exploitation. La valeur de ce paramètre doit être comprise entre les plages de numéros de version retournés dans le paramètre pDot11IHVVersionInfo du Dot11ExtIhvGetVersionInfo Fonction de gestionnaire IHV.

[in] pDot11ExtAPI

Pointeur vers une structure DOT11EXT_APIS , qui contient les adresses des fonctions 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 l’appel à la fonction Dot11ExtIhvInitService .

pvReserved

Ce paramètre est réservé au système d’exploitation.

[out] pDot11IHVHandlers

Pointeur vers une structure DOT11EXT_IHV_HANDLERS , qui contient les adresses des fonctions de gestionnaire IHV prises en charge par la DLL des extensions IHV. La DLL met en forme ce paramètre avec les adresses de fonction avant de retourner de l’appel à la fonction Dot11ExtIhvInitService .

Valeur retournée

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 Dot11ExtIhvInitService immédiatement après l’appel à Fonction Dot11ExtIhvGetVersionInfo . Lorsqu’il est appelé, Dot11ExtIhvInitService doit initialiser la DLL des extensions IHV si nécessaire. Lorsque la fonction est retournée, la DLL doit être prête à accepter des appels supplémentaires à la fonction gestionnaire IHV.

Contrairement à la façon dont il traite les autres fonctions d’extension et de gestionnaire IHV dont les adresses sont résolues via le paramètre pDot11IHVHandlers , le système d’exploitation résout l’adresse de la fonction Dot11ExtIhvInitService en appelant la fonction GetProcAddress . Par conséquent, le développeur de la DLL extensions IHV doit suivre ces instructions.

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

Pour plus d’informations sur GetProcAddress, reportez-vous à la documentation Microsoft Windows SDK.

Configuration requise

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

Voir aussi

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo