estructura DOT11_WFD_DISCOVER_REQUEST (windot11.h)

Artículo
08/08/2023

Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.

La estructura OID_DOT11_WFD_DISCOVER_REQUEST es los datos de entrada de una solicitud de OID_DOT11_WFD_DISCOVER_REQUEST . La estructura contiene los parámetros de una Wi-Fi detección directa de dispositivos.

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructuraOID_DOT11_WFD_DISCOVER_REQUEST . Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .

El controlador de minipuerto debe establecer los miembros de Header en los valores siguientes:

Tipo

Este miembro debe establecerse en NDIS_OBJECT_TYPE_DEFAULT.

Revisión

Este miembro debe establecerse en DOT11_WFD_DISCOVER_REQUEST_REVISION_1.

Size

Este miembro debe establecerse en sizeof(DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1).

Para obtener más información sobre estos miembros, vea NDIS_OBJECT_HEADER.

DiscoverType

Modo de detección de dispositivos que se va a usar.

ScanType

Tipo de examen utilizado durante la fase de examen de la detección de dispositivos.

uDiscoverTimeout

Tiempo máximo, en milisegundos, para completar la operación de detección. Sin embargo, un minipuerto puede completar una detección en menos tiempo, pero no debe usar más tiempo que el especificado por este valor. Este es el tiempo total permitido para la finalización de todas las fases de detección de dispositivos.

uDeviceFilterListOffset

Desplazamiento a la lista de filtros de dispositivo P2P, que especifica los dispositivos P2P y los propietarios del grupo que se van a buscar durante Wi-Fi detección directa de dispositivos. Este desplazamiento se especifica en bytes y es relativo al inicio del búfer que contiene la estructura DOT11_WFD_DISCOVER_REQUEST. Cada entrada de la lista tiene formato de DOT11_WFD_DISCOVER_DEVICE_FILTER.

Cuando una entrada de lista especifica una dirección MAC que no es de difusión como id. de dispositivo, el controlador debe usar esta dirección MAC en el atributo id. de dispositivo de las IE P2P que incluye en las solicitudes de sondeo.

Desplazamiento en informationBuffer de la NDIS_OID_REQUEST donde comienza una lista de identificadores de dispositivo P2P. Estos son los identificadores para durante la detección de dispositivos.

uNumDeviceFilters

El número de filtros de dispositivo P2P que se van a usar durante la detección de dispositivos WFD. El valor predeterminado de este campo es 0.

uIEsOffset

Desplazamiento en informationBuffer de la estructura NDIS_OID_REQUEST donde comienzan los elementos informativos (IE) adicionales.

uIEsLength

Longitud, en bytes, de las direcciones IP adicionales que el puerto de dispositivo directo Wi-Fi debe agregar al paquete de solicitud de sondeo. Si este valor es 0, el sistema no proporcionó ninguna E/S y el miniporte debe insertar las IE predeterminadas en el paquete de solicitud de sondeo. Las IEs predeterminadas se encuentran en DefaultRequestIEs recibidas anteriormente con una solicitud de OID_DOT11_WFD_ADDITIONAL_IE .

bForceScanLegacyNetworks

Cuando es TRUE, el dispositivo Wi-Fi Direct también debe intentar detectar redes heredadas. De lo contrario, no es necesario examinar las redes heredadas.

Comentarios

Cada entrada de la lista de identificadores de dispositivo en uDeviceFilterListOffset tiene el formato de estructura DOT11_MAC_ADDRESS . Cuando se especifica una dirección MAC que no es de difusión en esta lista, el controlador debe usar esta dirección en el atributo Id. de dispositivo de las solicitudes de sondeo de IEs P2P que transmite.

Las IEs presentes en uIEsOffset, mientras dure la detección de dispositivos, reemplazarán temporalmente las IEs encontradas en DefaultRequestIEs en la estructura de entrada de la solicitud de OID_DOT11_WFD_ADDITIONAL_IE .