énumération WLAN_NOTIFICATION_MSM (wlanapi.h)

Article
08/28/2023

Le type WLAN_NOTIFICATION_MSM énuméré spécifie les valeurs possibles du membre NotificationCode de la structure WLAN_NOTIFICATION_DATA pour les notifications MSM (Media Specific Module).

Syntaxe

typedef enum _WLAN_NOTIFICATION_MSM {
  wlan_notification_msm_start,
  wlan_notification_msm_associating,
  wlan_notification_msm_associated,
  wlan_notification_msm_authenticating,
  wlan_notification_msm_connected,
  wlan_notification_msm_roaming_start,
  wlan_notification_msm_roaming_end,
  wlan_notification_msm_radio_state_change,
  wlan_notification_msm_signal_quality_change,
  wlan_notification_msm_disassociating,
  wlan_notification_msm_disconnected,
  wlan_notification_msm_peer_join,
  wlan_notification_msm_peer_leave,
  wlan_notification_msm_adapter_removal,
  wlan_notification_msm_adapter_operation_mode_change,
  wlan_notification_msm_link_degraded,
  wlan_notification_msm_link_improved,
  wlan_notification_msm_end
} WLAN_NOTIFICATION_MSM, *PWLAN_NOTIFICATION_MSM;

Notes

Le WLAN_NOTIFICATION_ACM type énuméré est utilisé par le module spécifique au média, le nouveau composant de configuration sans fil pris en charge sur Windows Vista et versions ultérieures.

Le WLAN_NOTIFICATION_MSM spécifie les valeurs possibles pour le membre NotificationCode de la structure WLAN_NOTIFICATION_DATA pour les notifications reçues lorsque le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA est WLAN_NOTIFICATION_SOURCE_MSM.

La valeur de départ de l’énumération WLAN_NOTIFICATION_MSM est définie comme L2_NOTIFICATION_CODE_PUBLIC_BEGIN dans le fichier d’en-tête l2cmn.h . Notez que l’en-tête l2cmn.h est automatiquement inclus par le fichier d’en-tête wlanapi.h .

La fonction WlanRegisterNotification est utilisée par une application pour inscrire et annuler l’inscription des notifications sur toutes les interfaces sans fil. Lors de l’inscription aux notifications, une application doit fournir une fonction de rappel pointée vers le paramètre funcCallback passé à la fonction WlanRegisterNotification . Le prototype de cette fonction de rappel est le WLAN_NOTIFICATION_CALLBACK. Cette fonction de rappel reçoit des notifications qui ont été inscrites dans le paramètre dwNotifSource passé à la fonction WlanRegisterNotification .

La fonction de rappel est appelée avec un pointeur vers une structure WLAN_NOTIFICATION_DATA comme premier paramètre qui contient des informations détaillées sur la notification. La fonction de rappel reçoit également un deuxième paramètre qui contient un pointeur vers le contexte client passé dans le paramètre pCallbackContext à la fonction WlanRegisterNotification . Ce contexte client peut être un pointeur NULL si c’est ce qui a été passé à la fonction WlanRegisterNotification .