structure DOT11_WFD_DISCOVER_REQUEST (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 OID_DOT11_WFD_DISCOVER_REQUEST est les données d’entrée d’une requête OID_DOT11_WFD_DISCOVER_REQUEST. La structure contient les paramètres d’une découverte d’appareil direct Wi-Fi.

Syntaxe

typedef struct _DOT11_WFD_DISCOVER_REQUEST {
  NDIS_OBJECT_HEADER      Header;
  DOT11_WFD_DISCOVER_TYPE DiscoverType;
  DOT11_WFD_SCAN_TYPE     ScanType;
  ULONG                   uDiscoverTimeout;
  ULONG                   uDeviceFilterListOffset;
  ULONG                   uNumDeviceFilters;
  ULONG                   uIEsOffset;
  ULONG                   uIEsLength;
  BOOLEAN                 bForceScanLegacyNetworks;
} DOT11_WFD_DISCOVER_REQUEST, *PDOT11_WFD_DISCOVER_REQUEST;

Membres

Header

Type, révision et taille de la structureOID_DOT11_WFD_DISCOVER_REQUEST. Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER.

Le pilote miniport doit définir les membres de l’en-tête sur les valeurs suivantes :

Type

Ce membre doit être défini sur NDIS_OBJECT_TYPE_DEFAULT.

Révision

Ce membre doit être défini sur DOT11_WFD_DISCOVER_REQUEST_REVISION_1.

Taille

Ce membre doit être défini sur taille de(DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1).

Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.

DiscoverType

Mode de découverte d’appareil à utiliser.

ScanType

Type d’analyse utilisé pendant la phase d’analyse de la découverte d’appareils.

uDiscoverTimeout

Durée maximale, en millisecondes, pour terminer l’opération de découverte. Un miniport peut effectuer une découverte en moins de temps, mais il ne doit pas utiliser plus de temps que spécifié par cette valeur. Il s’agit du temps total autorisé pour la fin de toutes les phases de découverte d’appareils.

uDeviceFilterListOffset

Décalage vers la liste des filtres d’appareils P2P, qui spécifie les appareils P2P et les propriétaires de groupes à rechercher pendant Wi-Fi détection directe d’appareils. Ce décalage est spécifié en octets et est relatif au début de la mémoire tampon qui contient la structure DOT11_WFD_DISCOVER_REQUEST. Chaque entrée de la liste est mise en forme sous forme de DOT11_WFD_DISCOVER_DEVICE_FILTER.

Lorsqu’une entrée de liste spécifie une adresse MAC non diffusée comme ID d’appareil, le pilote doit utiliser cette adresse MAC dans l’attribut ID d’appareil des E/S P2P qu’il inclut dans les requêtes de sonde.

Décalage dans le InformationBuffer du NDIS_OID_REQUEST où commence une liste d’identificateurs d’appareil P2P. Il s’agit des identificateurs à rechercher pendant la découverte de l’appareil.

uNumDeviceFilters

Nombre de filtres d’appareils P2P à utiliser pendant la découverte d’appareils WFD. La valeur par défaut de ce champ est 0.

uIEsOffset

Décalage dans le InformationBuffer de la structure NDIS_OID_REQUEST où commencent les éléments informationnels (EE).

uIEsLength

Longueur, en octets, des EE supplémentaires que le port de l’appareil direct Wi-Fi doit ajouter au paquet de requête de sonde. Si cette valeur est 0, le système n’a pas fourni d’E/S et le miniport doit insérer les E/S par défaut dans le paquet de demande de sonde. Les E/S par défaut se trouvent dans DefaultRequestIEs reçues précédemment avec une demande de OID_DOT11_WFD_ADDITIONAL_IE.

bForceScanLegacyNetworks

Lorsque la valeur est TRUE, l’appareil direct Wi-Fi doit également tenter de découvrir les réseaux hérités. Sinon, l’analyse des réseaux hérités n’est pas nécessaire.

Remarques

Chaque entrée de la liste d’identificateurs d’appareil à uDeviceFilterListOffset est mise en forme sous forme de structure DOT11_MAC_ADDRESS. Lorsqu’une adresse MAC non diffusée est spécifiée dans cette liste, le pilote doit utiliser cette adresse dans l’attribut ID d’appareil de la sonde P2P IEs qu’il transmet

Les EI présentes à uIEsOffset, pendant la durée de la découverte de l’appareil, remplacent temporairement les EE trouvées à DefaultRequestIEs dans la structure d’entrée de la demande de OID_DOT11_WFD_ADDITIONAL_IE.