structure DOT11_WFD_DEVICE_ENTRY (windot11.h)

Article
02/07/2025

Important

WiFiCx est le nouveau modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités. Le modèle de pilote WDI est désormais en mode maintenance et ne reçoit que des correctifs de priorité élevée.

La structure DOT11_WFD_DEVICE_ENTRY contient des informations sur un appareil Wi-Fi direct (WFD), un propriétaire de groupe WFD (GO) découvert ou un point d’accès à l’infrastructure découvert. Cette structure est retournée à la fois à partir d’un OID_DOT11_WFD_ENUM_DEVICE_LIST et d’une notification de NDIS_STATUS_DOT11_WFD_DISCOVER_COMPLETE.

Syntaxe

typedef struct _DOT11_WFD_DEVICE_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  DOT11_MAC_ADDRESS                 TransmitterAddress;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullBeaconHostTimestamp;
  ULONGLONG                         ullProbeResponseHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBeaconIEsOffset;
  ULONG                             uBeaconIEsLength;
  ULONG                             uProbeResponseIEsOffset;
  ULONG                             uProbeResponseIEsLength;
}  DOT11_WFD_DEVICE_ENTRY, *PDOT11_WFD_DEVICE_ENTRY;

Membres

uPhyId

Identificateur du PHY utilisé pour détecter l’appareil. Cet identificateur se trouve dans la plage d’index de la liste des phYs pris en charge retournés à partir d’une demande de requête OID_DOT11_SUPPORTED_PHY_TYPES. Cet identificateur ne peut pas être DOT_PHY_ID_ANY.

PhySpecificInfo

Attributs du PHY identifié par uPhyId.

dot11BSSID

Adresse MAC de l’appareil qui a envoyé le paquet de réponse de la balise ou de la sonde lors d’une découverte.

dot11BSSType

Type de réseau BSS. Ce membre est défini sur dot11_BSS_type_infrastructure pour tous les appareils WFD détectés et les GO WFD.

TransmitterAddress

Adresse MAC de l’émetteur de l’appareil qui a envoyé le paquet de réponse de la balise ou de la sonde lors d’une découverte.

lRSSI

Valeur de l’indicateur de force du signal reçu de l’appareil découvert. Les unités de cette valeur sont en décbels référencés à 1 milliwatt (dBm).

uLinkQuality

Valeur de qualité de lien comprise entre 0 et 100. La valeur 100 indique la qualité de lien la plus élevée.

usBeaconPeriod

Valeur reçue du champ d’intervalle de balise du paquet de réponse de la balise ou de la sonde la plus récente.

ullTimestamp

Valeur reçue du champ timestamp du paquet de réponse de la balise ou de la sonde la plus récente.

ullBeaconHostTimestamp

Horodatage, déterminé par une valeur retournée par NdisGetCurrentSystemTime, enregistrant l’heure à laquelle le paquet de balises a été reçu.

ullProbeResponseHostTimestamp

Horodatage, déterminé par une valeur retournée par NdisGetCurrentSystemTime, enregistrant l’heure à laquelle le paquet de réponse de la sonde a été reçu.

usCapabilityInformation

Valeur reçue du champ de capacité du dernier paquet de réponse de la balise ou de la sonde.

uBeaconIEsOffset

Décalage, en octets, à partir du début de cette structure de la liste des éléments d’information (EE) du dernier paquet de balise reçu de cet appareil. Si aucun paquet de balises n’a été reçu, cette valeur doit être 0.

uBeaconIEsLength

Longueur, en octets, des EE à uBeaconIEsOffset. Il s’agit d’une valeur de longueur exacte et ne contient aucun remplissage pour l’alignement. Si aucun paquet de balises n’a été reçu, cette valeur doit être 0.

uProbeResponseIEsOffset

Décalage, en octets, à partir du début de cette structure de la liste des éléments d’information (EE) du dernier paquet de réponse de sonde reçu de cet appareil. Si aucun paquet de balises n’a été reçu, cette valeur doit être 0.

uProbeResponseIEsLength

Longueur, en octets, des EE à uProbeResponseIEsOffset. Il s’agit d’une valeur de longueur exacte et ne contient aucun remplissage pour l’alignement. Si aucun paquet de réponse de sonde n’a été reçu, cette valeur doit être 0.