estructura DOT11_ASSOCIATION_COMPLETION_PARAMETERS (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_ASSOCIATION_COMPLETION_PARAMETERS especifica los resultados de la operación de asociación realizada por la estación 802.11 con un punto de acceso (AP) o una estación del mismo nivel. El controlador de minipuerto Native 802.11 incluye una estructura de DOT11_ASSOCIATION_COMPLETION_PARAMETERS cuando el controlador de minipuerto realiza una indicación de estado NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION .
Sintaxis
typedef struct DOT11_ASSOCIATION_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS MacAddr;
DOT11_ASSOC_STATUS uStatus;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
ULONG uIHVDataOffset;
ULONG uIHVDataSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
BOOLEAN bFourAddressSupported;
BOOLEAN bPortAuthorized;
UCHAR ucActiveQoSProtocol;
DOT11_DS_INFO DSInfo;
ULONG uEncapTableOffset;
ULONG uEncapTableSize;
DOT11_CIPHER_ALGORITHM MulticastMgmtCipher;
ULONG uAssocComebackTime;
} DOT11_ASSOCIATION_COMPLETION_PARAMETERS, *PDOT11_ASSOCIATION_COMPLETION_PARAMETERS;
Miembros
Header
Tipo, revisión y tamaño de la estructura DOT11_ASSOCIATION_COMPLETION_PARAMETERS. Este miembro tiene 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_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1.
Size
Este miembro debe establecerse en sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS).
Para obtener más información sobre estos miembros, consulte NDIS_OBJECT_HEADER.
MacAddr
Dirección de control de acceso multimedia (MAC) del punto de acceso (AP) (para redes BSS de infraestructura) o estación del mismo nivel (para redes BSS (IBSS) independientes) a las que la estación 802.11 intentó conectarse.
uStatus
Estado de finalización de la operación de asociación, tal como se especifica en un valor definido para DOT11_ASSOC_STATUS.
bReAssocReq
Valor booleano que indica si la estación 802.11 envió un marco 802.11 Association o Reassociation al AP. Si es TRUE, la estación 802.11 envió un marco de solicitud de reasociación 801.11 al AP. Si es FALSE, la estación 802.11 envió un marco de solicitud de asociación 802.11 al AP.
Un valor true para el miembro bReAssocReq solo es válido si el objeto MIB dot11DesiredBSSType está establecido en dot11_BSS_type_infrastructure.
bReAssocResp
Valor booleano que indica si la estación 802.11 recibió un marco 802.11 Association o Reassociation del AP. Si es TRUE, la estación 802.11 recibió un marco de respuesta 802.11 de la AP. Si es FALSE, la estación 802.11 recibió un marco de respuesta de asociación 802.11 del AP.
Un valor true para el miembro bReAssocResp solo es válido si el objeto MIB dot11DesiredBSSType está establecido en dot11_BSS_type_infrastructure.
uAssocReqOffset
Desplazamiento del marco de solicitud que se usa en la operación de asociación. El marco no incluye el encabezado MAC 802.11.
Este desplazamiento es relativo al inicio del búfer que contiene la estructura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
El marco solicitud de asociación devuelto por el controlador de minipuerto depende del valor del objeto MIB IEEE 802.11 dot11DesiredBSSType :
- Si el objeto MIB dot11DesiredBSSType está establecido en dot11_BSS_type_infrastructure, el marco es el marco de solicitud de asociación 802.11 (si bReAssocReq es FALSE) o marco solicitud de reasociación (si bReAssocReq es TRUE) que se envió a la API. El controlador de minipuerto debe devolver un marco de solicitud de sondeo 802.11 enviado por el iniciador de asociación o creado por el controlador en función de la información intercambiada durante la operación de asociación.
- Si el objeto MIB dot11DesiredBSSType está establecido en dot11_BSS_type_independent, el controlador de minipuerto debe establecer el miembro uAssocReqOffset en cero.
El controlador de minipuerto debe establecer los miembros uAssocReqOffset y uAssocReqSize en cero si no pudo enviar un marco de solicitud durante la operación de asociación. Por ejemplo, si el AP produjo un error en el marco de autenticación 802.11 enviado por la estación 802.11, el controlador de miniport debe establecer uAssocReqOffset y uAssocReqSize en cero.
uAssocReqSize
Longitud del marco de solicitud que se usa en la operación de asociación. La longitud del marco no incluye el encabezado MAC 802.11.
Si el objeto MIB dot11DesiredBSSType está establecido en dot11_BSS_type_independent, el controlador de minipuerto debe establecer el miembro uAssocReqSize en cero.
uAssocRespOffset
Desplazamiento del marco de respuesta que se usa en la operación de asociación. El marco no incluye el encabezado MAC 802.11.
Este desplazamiento es relativo al inicio del búfer, que contiene la estructura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
El marco de respuesta de asociación devuelto por el controlador de minipuerto depende del valor del objeto MIB IEEE 802.11 dot11DesiredBSSType :
Si el objeto MIB dot11DesiredBSSType está establecido en dot11_BSS_type_infrastructure, el marco es el marco de respuesta de asociación 802.11 (si bReAssocReq es TRUE) o marco de respuesta de reassociation (si bReAssocReq es FALSE) que se recibió de la AP. El controlador de minipuerto debe devolver un marco de respuesta de sondeo 802.11 que se envía al iniciador de asociación o creado por el controlador en función de la información intercambiada durante la operación de asociación.
Si el objeto MIB dot11DesiredBSSType se establece en dot11_BSS_type_independent, el controlador de minipuerto debe establecer el miembro uAssocRespOffset en cero.
El controlador de minipuerto debe establecer los miembros uAssocRespOffset y uAssocRespSize en cero si no recibió un marco de respuesta durante la operación de asociación.
uAssocRespSize
Longitud del marco de respuesta que se usa en la operación de asociación. La longitud del marco no incluye el encabezado MAC 802.11.
Si el objeto MIB dot11DesiredBSSType está establecido en dot11_BSS_type_independent, el controlador de minipuerto debe establecer el miembro uAssocRespSize en cero.
uBeaconOffset
El desplazamiento de los últimos fotogramas 802.11 Beacon o Probe Response recibidos. El controlador miniport debe excluir el encabezado MAC 802.11 para estos fotogramas al realizar la indicación de estado de NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION .
Este desplazamiento es relativo al inicio del búfer, que contiene la estructura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Nota
Si el algoritmo de autenticación usado en la asociación era Wi-Fi acceso protegido (WPA) o IEEE 802.11i Robust Security Network Association (RSNA), el controlador de miniport siempre debe devolver el último marco de baliza recibido 802.11 y no debe establecer los miembros uBeaconOffset y uBeaconSize en cero.
uBeaconSize
La longitud del último marco de baliza recibido 802.11. La longitud del marco no incluye el encabezado MAC 802.11.
uIHVDataOffset
Desplazamiento de un bloque de datos en un formato propietario definido por el IHV. El IHV puede usar este bloque de datos para cualquier propósito relacionado con la indicación de estado de NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION .
Este desplazamiento es relativo al inicio del búfer, que contiene la estructura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Si el controlador de miniporte no devuelve datos de IHV en la indicación de estado NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION , debe establecer uIHVDataOffset en cero.
uIHVDataSize
Longitud del bloque de datos que usa el IHV para la indicación de estado de NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION . Si el controlador de miniporte no devuelve datos de IHV en esta indicación, debe establecer uIHVDataSize en cero.
AuthAlgo
Algoritmo de autenticación que la estación 802.11 resolvió con el AP o la estación del mismo nivel durante la operación de asociación. Para obtener más información sobre el tipo de datos para el miembro AuthAlgo , consulte DOT11_AUTH_ALGORITHM.
El controlador de minipuerto debe establecer este miembro en cero si uStatus no está establecido en DOT11_ASSOCIATION_STATUS_SUCCESS.
UnicastCipher
Algoritmo de cifrado de unidifusión que la estación 802.11 resolvió con el AP o la estación del mismo nivel durante la operación de asociación. Para obtener más información sobre el tipo de datos para el miembro UnicastCipher , consulte DOT11_CIPHER_ALGORITHM.
El controlador de minipuerto debe establecer este miembro en cero si uStatus no está establecido en DOT11_ASSOCIATION_STATUS_SUCCESS.
MulticastCipher
Algoritmo de cifrado de multidifusión que la estación 802.11 resolvió con el AP o la estación del mismo nivel durante la operación de asociación. Para obtener más información sobre el tipo de datos para el miembro MulticastCipher , consulte DOT11_CIPHER_ALGORITHM
El controlador de minipuerto debe establecer este miembro en cero si uStatus no está establecido en DOT11_ASSOCIATION_STATUS_SUCCESS.
uActivePhyListOffset
Desplazamiento de la lista de identificadores PHY (ID) que la estación 802.11 usa para enviar o recibir paquetes en la conexión de red BSS.
El objeto MIB Extensible Station (ExtSTA) msDot11ActivePhyList también hace referencia a la lista PHY activa.
Para obtener más información sobre este objeto MIB, vea OID_DOT11_ACTIVE_PHY_LIST.
Las entradas de la lista PHY activa pueden ser uno de los siguientes valores:
- Identificador de PHY especificado por el objeto MIB ExtSTA msDot11DesiredPhyList . Para obtener más información sobre este objeto MIB, vea OID_DOT11_DESIRED_PHY_LIST.
- DOT11_PHY_ID_ANY. El controlador miniport puede establecer una entrada en este valor si el objeto MIB msDot11ActivePhyList especifica todos los identificadores PHY especificados por el objeto MIB msDot11DesiredPhyList . Una entrada con el valor de DOT11_PHY_ID_ANY debe ser la única entrada de la lista PHY activa.
El desplazamiento de la lista PHY activa es relativo al inicio del búfer que contiene la estructura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
El controlador de miniport debe establecer los miembros uActivePhyListOffset y uActivePhyListSize en cero si uStatus no está establecido en DOT11_ASSOCIATION_STATUS_SUCCESS.
uActivePhyListSize
Longitud de la lista PHY activa. El miembro uActivePhyListSize debe ser un múltiplo de sizeof(ULONG).
bFourAddressSupported
Valor booleano que, si se establece en TRUE, especifica que la estación 802.11 tiene asociada a un AP que admite los servicios del sistema de distribución (DS) para el puente iso nivel 2 en cualquier estación de la red BSS, incluidas las estaciones móviles y los AP. La determinación de este apoyo es específica de la implementación por parte del IHV.
Un controlador de minipuerto debe establecer el miembro bFourAddressSupported enFALSE si se cumple alguna de las siguientes condiciones:
- El objeto MIB IEEE 802.11 dot11DesiredBSSType se establece en dot11_BSS_type_independent.
- La estación 802.11 no se asoció con un AP que admita servicios DS o no puede determinar si el AP admite servicios DS.
- El miembro uStatus no está establecido en DOT11_ASSOCIATION_STATUS_SUCCESS.
bPortAuthorized
Valor booleano que, si se establece en TRUE, especifica que la estación 802.11 ha realizado correctamente la autorización del puerto durante la operación de asociación. La autorización de puerto podría basarse en los estándares IEEE 802.1X/802.11i o en un algoritmo propietario desarrollado por el IHV.
El controlador de minipuerto debe establecer bPortAuthorized enFALSE si se cumple alguna de las siguientes condiciones:
- La estación 802.11 no realiza la autorización del puerto.
- El miembro uStatus no está establecido en DOT11_ASSOCIATION_STATUS_SUCCESS.
Para obtener más información sobre la autorización de puertos, consulte Acceso de red basado en puertos.
ucActiveQoSProtocol
Marca que especifica la calidad del protocolo de servicio (QoS) que está activo actualmente para esta asociación. Este miembro es cero (lo que indica que no hay ningún protocolo QoS activo) o una de las marcas siguientes:
DOT11_QOS_PROTOCOL_FLAG_WMM
La NIC usa el protocolo QoS 802.11 WMM.
DOT11_QOS_PROTOCOL_FLAG_11E
La NIC usa el protocolo QoS 802.11e.
DSInfo
Valor de DOT11_DS_INFO que especifica si la estación 802.11 está conectada al mismo DS desde la operación de asociación anterior.
El miembro DSInfo tiene el formato de enumeración DOT11_DS_INFO, que especifica los siguientes valores:
DOT11_DS_CHANGED
La estación 802.11 se ha conectado a un nuevo DS después de la operación de asociación.
DOT11_DS_UNCHANGED
La estación 802.11 está conectada al mismo DS desde la operación de asociación.
DOT11_DS_UNKNOWN
El controlador de minipuerto no puede determinar si el DS ha cambiado después de la operación de asociación.
Nota
El controlador de minipuerto debe establecer DSInfoen DOT11_DS_UNKNOWN si el objeto MIB dot11DesiredBSSType está establecido en dot11_BSS_type_independent.
uEncapTableOffset
Desplazamiento de la lista de encapsulaciones IEEE EtherType para la asociación BSS.
Este desplazamiento es relativo al inicio del búfer, que contiene la estructura DOT11_ASSOCIATION_COMPLETION_PARAMETERS. El valor de uEncapTableOffset debe alinearse en un límite de 4 bytes.
El controlador de minipuerto da formato a cada entrada de esta lista como una estructura de DOT11_ENCAP_ENTRY .
Para obtener más información sobre la lista de encapsulación EtherType, vea Encapsulación de carga 802.11.
uEncapTableSize
Longitud de la lista de encapsulación EtherType.
MulticastMgmtCipher
El algoritmo de cifrado de multidifusión que elige la NIC (negocia) para la asociación para la protección de fotogramas de administración (MFP). Si se negocia MFP, este miembro debe ser DOT11_CIPHER_ALGO_BIP. Si no se negocia MFP, este campo debe ser DOT11_CIPHER_ALGO_NONE.
uAssocComebackTime
Cuando se produce un error en una (re)asociación con el código de motivo 30 802.11 ("Solicitud de asociación rechazada temporalmente, inténtelo de nuevo más tarde"). Este miembro indica el valor del tiempo de devolución de asociación solicitado por el punto de acceso (AP). El código de motivo de desasociación 802.11 está presente en los 16 bits más bajos de uStatus al responder a una solicitud de asociación.
El servicio de conexión automática de Windows agregará el AP a una lista de bloqueados y no intentará volver a conectarse durante al menos el tiempo de retorno indicado. La NIC se comportará como una autenticación con error normal hasta que se inicie la siguiente secuencia de conexión. Una vez transcurrido el tiempo de espera(comeback) indicado y el proceso de conexión se detiene Windows puede encontrar una mejor conexión alternativa o volver a esta conexión. Este valor establecido en este miembro debe usar las unidades de tiempo definidas en la especificación 802.11. Por ejemplo, TU.
Comentarios
El controlador de minipuerto debe establecer los miembros uEncapTableOffset y uEncapTableSize en cero si se cumple alguna de las siguientes condiciones:
- La asociación BSS no requiere cambios en la lista predeterminada del sistema operativo de encapsulaciones EtherType.
- El miembro uStatus no está establecido en DOT11_ASSOCIATION_STATUS_SUCCESS.
- El objeto de base de información de administración (MIB) dot11DesiredBSSType de la estación extensible (ExtSTA) se establece en dot11_BSS_type_independent.
Para obtener más información sobre el objeto MIB IEEE 802.11 dot11DesiredBSSType , vea OID_DOT11_DESIRED_BSS_TYPE.
Para obtener más información sobre la operación de asociación, vea Operaciones de asociación.
La protección de fotogramas de administración se negocia cuando un punto de acceso (AP) y STA establecen el campo Management Frame Protection Capable (MFPC) en 1 en sus respectivos IE de RSN durante el procedimiento de asociación (re)association procedure (es decir, Respuesta de baliza o sondeo para AP y (re)solicitud de asociación para STA), y ambas partes confirman el bit Compatible con protección de fotogramas de administración establecido en 1 en el protocolo de enlace de 4 vías (Mensajes M2 y M3 del protocolo de enlace 802.11i 4-way).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 8 y versiones posteriores de los sistemas operativos Windows. |
| Encabezado | windot11.h (incluye Ndis.h) |