DOT11EXTIHV_PERFORM_POST_ASSOCIATE fonction de rappel (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 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 Dot11ExtIhvPerformPostAssociate pour demander que la DLL des extensions IHV lance une opération post-association avec le réseau BSS (Basic Service Set).

Syntaxe

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

Paramètres

[in, optional] hIhvExtAdapter

Handle utilisé par la DLL des extensions IHV pour référencer l’adaptateur LAN sans fil (WLAN). Cette valeur de handle a été spécifiée par le biais d’un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter .

[in, optional] hSecuritySessionID

Handle de la session de sécurité. La DLL des extensions IHV doit utiliser cette valeur de handle lorsqu’elle appelle Dot11ExtPostAssociateCompletion pour terminer de manière asynchrone l’opération post-association.

[in] pPortState

Pointeur vers une structure DOT11_PORT_STATE , qui spécifie l’état actuel du port de la session de sécurité.

[in] uDot11AssocParamsBytes

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

[in] pDot11AssocParams

Pointeur vers un DOT11_ASSOCIATION_COMPLETION_PARAMETERS structure, qui spécifie le résultat de l’opération d’association effectuée par l’adaptateur WLAN. Le pilote miniport Native 802.11, qui gère l’adaptateur WLAN, inclut une structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS lorsqu’il rend un média spécifique NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication.

Pour plus d’informations sur l’opération d’association, consultez Opérations d’association.

Valeur retournée

Si la DLL d’extension IHV peut lancer l’opération post-association, elle doit terminer l’opération de manière asynchrone. Dans ce cas, la fonction retourne ERROR_SUCCESS.

Si la DLL des extensions IHV ne peut pas lancer l’opération post-association, elle retourne un code d’erreur défini dans Winerror.h.

Remarques

Le système d’exploitation appelle la fonction Dot11ExtIhvPerformPostAssociate pour lancer une opération post-association avec la DLL des extensions IHV. Le système d’exploitation lance cette opération une fois que l’adaptateur WLAN a terminé une opération d’association avec un point d’accès (AP) dans un réseau BSS (Infrastructure Basic Service Set).

Note Pour Windows Vista, la DLL extensions IHV prend uniquement en charge les réseaux BSS (Infrastructure Basic Service Set).

Pour plus d’informations sur l’opération d’association, consultez Opérations d’association.

L’opération post-association doit être effectuée de façon asynchrone à partir de l’appel à Dot11ExtIhvPerformPostAssociate. Une fois l’opération post-association terminée, la DLL doit appeler Dot11ExtPostAssociateCompletion.

Si la DLL des extensions IHV peut lancer l’opération post-association, la fonction Dot11ExtIhvPerformPostAssociate doit retourner ERROR_SUCCESS et terminer l’opération de manière asynchrone.

Pour plus d’informations sur l’opération post-association, consultez Opérations post-association.

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, Windot11.h, L2cmn.h)

Voir aussi

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION

Partager via