estructura de DOT11_PHY_TYPE_INFO (windot11.h)

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 dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.

La estructura DOT11_PHY_TYPE_INFO define los parámetros que usa la estación 802.11 para configurar un PHY al realizar una operación de examen explícita. La estación realiza la operación de examen explícita después de una solicitud establecida de OID_DOT11_SCAN_REQUEST.

Sintaxis

typedef struct _DOT11_PHY_TYPE_INFO {
  union {
    DOT11_PHY_TYPE dot11PhyType;
    ULONG          uPhyId;
  };
  BOOLEAN             bUseParameters;
  ULONG               uProbeDelay;
  ULONG               uMinChannelTime;
  ULONG               uMaxChannelTime;
  CH_DESCRIPTION_TYPE ChDescriptionType;
  ULONG               uChannelListSize;
  UCHAR               ucChannelListBuffer[1];
} DOT11_PHY_TYPE_INFO, *PDOT11_PHY_TYPE_INFO;

Miembros

dot11PhyType

Tipo de PHY que usará la estación 802.11 para el examen. El tipo PHY se define mediante la enumeración DOT11_PHY_TYPE .

Nota El controlador de minipuerto debe omitir este miembro si está funcionando en modo Estación extensible (ExtSTA).

bUseParameters

Si este miembro es TRUE, la estación 802.11 usa los demás miembros de esta estructura para configurar el PHY para la operación de examen.

Si este miembro es FALSE, la estación 802.11 configura el PHY con sus propios valores para la operación de examen.

Nota Si el controlador de miniporte funciona en modo ExtSTA, el sistema operativo siempre establecerá este miembro en FALSE.

uProbeDelay

Cantidad de tiempo, en microsegundos, que la estación 802.11 debe esperar antes de transmitir un marco de solicitud de sondeo 802.11 durante el examen activo.

uMinChannelTime

La cantidad mínima de tiempo, en 802,11 unidades de tiempo (TU), que la estación 802.11 pasa en cada canal al examinar. Un TU es 1024 microsegundos.

Este miembro debe ser mayor o igual que uProbeDelay .

uMaxChannelTime

La cantidad máxima de tiempo, en 802,11 unidades de tiempo (TU), que la estación 802.11 pasa en cada canal al escanear.

Este miembro debe ser mayor o igual que uProbeDelay .

ChDescriptionType

Este miembro especifica el método utilizado para interpretar las entradas de la matriz ucChannelListBuffer . El tipo de datos de este miembro es la enumeración CH_DESCRIPTION_TYPE, que declara los siguientes valores:

ch_description_type_logical

La entrada del canal se define mediante un número de canal lógico que se ajusta al estándar IEEE 802.11.

ch_description_type_center_frequency

La entrada del canal se define, en unidades de megahercios (MHz), por una frecuencia central del canal.

uChannelListSize

Longitud, en bytes, de la matriz ucChannelListBuffer . Cada entrada de esta matriz tiene formato de tipo de datos ULONG.

ucChannelListBuffer[1]

Matriz que contiene descripciones de canal para el tipo PHY especificado en el miembro dot11PhyType .

Comentarios

La estructura DOT11_SCAN_REQUEST_V2 , que acompaña a una solicitud establecida de OID_DOT11_SCAN_REQUEST, contiene una matriz de cero o más entradas DOT11_PHY_TYPE_INFO.

Para obtener más información sobre las operaciones de examen realizadas por un controlador de miniporte nativo 802.11, consulte Operaciones de examen nativas 802.11.

Para obtener más información sobre el modo de operación ExtSTA, vea Modo de operación de estación extensible.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado	windot11.h (incluye Ndis.h)

Consulte también

DOT11_SCAN_REQUEST_V2

OID_DOT11_SCAN_REQUEST