estructura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS (windot11.h)
La estructura 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 una infraestructura BSS.
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 el formato de una estructura NDIS_OBJECT_HEADER.
El controlador de miniport debe establecer los miembros de Encabezado 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.
Tamaño
Este miembro debe establecerse en sizeof(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS).
Para obtener más información sobre estos miembros, vea 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 siguientes valores:
DOT11_ASSOC_ERROR_SOURCE_OS
El controlador de miniporte ha rechazado el procedimiento de asociación debido a errores del sistema, como errores de memoria insuficiente. En este caso, uStatus debe establecerse en el código NDIS_STATUS_XXX o NTSTATUS_XXX 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. Tabla 19 en el ESPECIFICACIÓN IEEE 802.11-2003 contiene todos los valores posibles. El controlador miniport 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 (IEs), 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 (IEs), 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 (IEs), 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 (IEs), 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 del miembro de AuthAlgo, vea DOT11_AUTH_ALGORITHM.
UnicastCipher
El 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 del miembro unicastCipher de, vea DOT11_CIPHER_ALGORITHM.
MulticastCipher
El 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 de multidifusión de multidifusión, vea DOT11_CIPHER_ALGORITHM.
uActivePhyListOffset
Desplazamiento de la lista de identificadores PHY (ID) que usa la estación 802.11 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 objeto 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 PHY especificado por el objeto extensible Station (ExtSTA) msDot11DesiredPhyList objeto de base de información de administración (MIB). Para obtener más información sobre este objeto MIB, vea OID_DOT11_DESIRED_PHY_LIST.
-
Identificador PHY de DOT11_PHY_ID_ANY. El controlador de miniport puede establecer una entrada en este valor si extSTA msDot11ActivePhyList objeto MIB especifica todos los identificadores PHY especificados por el objeto msDot11DesiredPhyList objeto MIB. 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 fotograma 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 trama de datos o el estado de asociación de cliente, como marca de tiempo, 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 trama de datos o el estado de asociación de cliente, como marca de tiempo, parámetros de radio, TIM, ERP y HT IEs, no es necesario ser preciso,
Observaciones
El controlador de miniporte 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 de . Si la asociación se realiza correctamente, la NIC debe realizar la indicación del 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 realizar la NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indicación de 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 7 y versiones posteriores del sistema operativo Windows. |
| encabezado de | windot11.h (incluye Ndis.h) |