estructura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS (windot11.h)
La estructura de DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS especifica los resultados de la operación de asociación que realiza la estación 802.11 después de recibir una solicitud de asociación de una estación del mismo nivel en un BSS de infraestructura.
Sintaxis
typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS PeerMacAddr;
ULONG uStatus;
UCHAR ucErrorSource;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;
Miembros
Header
Tipo, revisión y tamaño de la estructura DOT11_INCOMING_ASSOC_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_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1.
Size
Este miembro debe establecerse en sizeof(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS).
Para obtener más información sobre estos miembros, consulte NDIS_OBJECT_HEADER.
PeerMacAddr
Dirección del control de acceso multimedia (MAC) de la estación del mismo nivel que envió una solicitud de asociación.
uStatus
Estado de la asociación con la estación del mismo nivel. Si es cero, la asociación se realiza correctamente. Si no es cero, se produce un error en la asociación.
ucErrorSource
Para los valores distintos de cero de uStatus, este miembro indica el origen del error que impide la asociación. La NIC debe establecer ucErrorSource en uno de los valores siguientes:
DOT11_ASSOC_ERROR_SOURCE_OS
El controlador de minipuerto ha rechazado el procedimiento de asociación debido a errores del sistema, como errores fuera de memoria. En este caso, uStatus debe establecerse en el NDIS_STATUS_XXX o NTSTATUS_XXX código devuelto desde el sistema operativo.
DOT11_ASSOC_ERROR_SOURCE_REMOTE
El AP o la estación del mismo nivel han rechazado el procedimiento de asociación. En este caso, uStatus debe establecerse en el código de estado 802.11 con el marco de autenticación 802.11, el marco de respuesta de asociación o el marco de respuesta de nueva asociación. La tabla 19 de la especificación IEEE 802.11-2003 contiene todos los valores posibles. El controlador de minipuerto también puede devolver nuevos valores en esta especificación IEEE cuando se modifica.
DOT11_ASSOC_ERROR_SOURCE_OTHER
Error en la asociación por un motivo específico de IHV. En este caso, uStatus contiene un valor distinto de cero especificado por el IHV.
bReAssocReq
Valor booleano que indica si la solicitud de la estación del mismo nivel es una solicitud de nueva asociación.
bReAssocResp
Valor booleano que indica si la respuesta de la NIC es una solicitud de nueva asociación.
uAssocReqOffset
Desplazamiento del marco de solicitud que se usa en la operación de asociación. El marco incluye elementos de información (IE), pero no incluye el encabezado MAC 802.11.
uAssocReqSize
Longitud, en bytes, del marco de solicitud que se usa en la operación de asociación. El marco incluye elementos de información (IE), pero no incluye el encabezado MAC 802.11.
uAssocRespOffset
Desplazamiento del marco de respuesta que se usa en la operación de asociación. El marco incluye elementos de información (IE), pero no incluye el encabezado MAC 802.11.
uAssocRespSize
Longitud del marco de respuesta, en bytes, que se usa en la operación de asociación. El marco incluye elementos de información (IE), pero no incluye el encabezado MAC 802.11.
AuthAlgo
Algoritmo de autenticación que la estación 802.11 resolvió con 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.
UnicastCipher
Algoritmo de cifrado de unidifusión que la estación 802.11 resolvió con 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.
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.
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. Cada entrada es un valor de ULONG.
La estación extensible (ExtSTA) msDot11ActivePhyList MIB también hace referencia a la lista PHY activa.
Las entradas de la lista PHY activa pueden ser uno de los siguientes valores:
- Identificador de PHY especificado por el objeto base de información de administración (MIB) de estación extensible (ExtSTA) msDot11DesiredPhyList . Para obtener más información sobre este objeto MIB, vea OID_DOT11_DESIRED_PHY_LIST.
-
Id. de PHY de DOT11_PHY_ID_ANY. El controlador de minipuerto puede establecer una entrada en este valor si el objeto MIB ExtSTA msDot11ActivePhyList especifica todos los identificadores PHY especificados por el objeto MIB msDot11DesiredPhyList . Para obtener más información sobre este objeto MIB, vea OID_DOT11_ACTIVE_PHY_LIST.
Nota Una entrada con el valor de DOT11_PHY_ID_ANY debe ser la única entrada de la lista PHY activa.
uActivePhyListSize
Longitud, en bytes, de la lista PHY activa. El miembro uActivePhyListSize debe ser un múltiplo de sizeof(ULONG).
uBeaconOffset
Desplazamiento, en bytes, del último marco de baliza transmitido 802.11.
El marco Beacon incluye el encabezado del marco Beacon y todos los elementos de información (IEs), pero no incluye el encabezado MAC 802.11. El formato de marco Beacon se define en ISO/IEC 8802-11.
El marco Beacon debe ser el marco más reciente utilizado por el controlador, salvo que los parámetros o IE en tiempo real que varían con el control de flujo de fotogramas de datos, o el estado de asociación de cliente, como la marca de tiempo, los parámetros de radio, TIM, ERP y HT IEs, no es necesario ser preciso,
uBeaconSize
Longitud, en bytes, del último marco de baliza transmitido 802.11.
El marco Beacon incluye el encabezado del marco Beacon y todos los elementos de información (IEs), pero no incluye el encabezado MAC 802.11. El formato de marco Beacon se define en ISO/IEC 8802-11.
El marco Beacon debe ser el marco más reciente utilizado por el controlador, salvo que los parámetros o IE en tiempo real que varían con el control de flujo de fotogramas de datos, o el estado de asociación de cliente, como la marca de tiempo, los parámetros de radio, TIM, ERP y HT IEs, no es necesario ser preciso,
Comentarios
El controlador de minipuerto Native 802.11 incluye una estructura de DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS cuando el controlador realiza una NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indicación de estado.
La indicación de estado NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION marca el final de un bloque de indicación de asociación. Si la asociación se realiza correctamente, la NIC debe hacer la indicación de NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION después de enviar correctamente el marco de respuesta de asociación correspondiente a la estación que originalmente solicitó la asociación. Si se produce un error en la asociación, la NIC debe hacer que la NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indica si la respuesta se envía correctamente o no. El error puede deberse a que la NIC o el sistema operativo rechazan la solicitud de asociación o debido a un error no relacionado con el marco 802.11.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 7 y versiones posteriores del sistema operativo Windows. |
| Encabezado | windot11.h (incluye Ndis.h) |