estructura DOT11_STATISTICS (windot11.h)
La estructura DOT11_STATISTICS registra contadores estadísticos para la interfaz 802.11.
Sintaxis
typedef struct DOT11_STATISTICS {
NDIS_OBJECT_HEADER Header;
ULONGLONG ullFourWayHandshakeFailures;
ULONGLONG ullTKIPCounterMeasuresInvoked;
ULONGLONG ullReserved;
DOT11_MAC_FRAME_STATISTICS MacUcastCounters;
DOT11_MAC_FRAME_STATISTICS MacMcastCounters;
DOT11_PHY_FRAME_STATISTICS PhyCounters[1];
} DOT11_STATISTICS, *PDOT11_STATISTICS;
Miembros
Header
Tipo, revisión y tamaño de la estructura DOT11_STATISTICS. 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_STATISTICS_REVISION_1.
Size
Este miembro debe establecerse sizeof(DOT11_STATISTICS)en .
Para obtener más información sobre estos miembros, vea NDIS_OBJECT_HEADER.
ullFourWayHandshakeFailures
Número de errores de protocolo de enlace bidireccionales que encontró la estación 802.11 durante Wi-Fi autenticación de asociación de red de seguridad sólida (RSNA) o acceso protegido (WPA).
Si la estación 802.11 no realiza la autenticación WPA o RSNA, debe establecer este miembro en DOT11_STATISTICS_UNKNOWN.
ullTKIPCounterMeasuresInvoked
Número de veces que la estación 802.11 invocó contramedidas después de un error de código de integridad de mensaje (MIC).
Si la estación 802.11 no realiza contramedidas TKIP, debe establecer este miembro en DOT11_STATISTICS_UNKNOWN.
ullReserved
Este miembro está reservado para que lo use el sistema operativo. El controlador de minipuerto no debe escribir en este miembro.
MacUcastCounters
Los contadores de capa MAC basados en paquetes de unidifusión enviados o recibidos por la estación 802.11. La estructura de datos de este miembro es la DOT11_MAC_FRAME_STATISTICS estructura.
Los contadores de los paquetes de unidifusión recibidos solo deben incrementarse para esos paquetes con una dirección MAC de destino en el encabezado MAC 802.11 que coincida con la dirección MAC de la estación 802.11.
MacMcastCounters
Los contadores de capa MAC basados en paquetes de multidifusión o difusión enviados o recibidos por la estación 802.11. La estructura de datos de este miembro es la DOT11_MAC_FRAME_STATISTICS estructura.
Los contadores de los paquetes de multidifusión o difusión recibidos solo deben incrementarse para esos paquetes con una dirección MAC de destino en el encabezado MAC 802.11 que coincida con una entrada en la lista de direcciones de multidifusión de la estación 802.11. Para obtener más información sobre la lista de direcciones de multidifusión, consulte OID_DOT11_MULTICAST_LIST.
PhyCounters[1]
Matriz de contadores de capas PHY. Cada entrada de esta matriz tiene el formato DOT11_PHY_FRAME_STATISTICS estructura.
El controlador de minipuerto debe mantener una entrada dentro de la matriz PhyCounters para cada PHY compatible. Si la estación 802.11 admite varios PHY del mismo tipo, el controlador de minipuerto debe crear entradas independientes para cada uno.
Las entradas de la matriz PhyCounters deben estar en el mismo orden que la lista de PHY admitidos que devuelve el controlador cuando se consulta mediante OID_DOT11_SUPPORTED_PHY_TYPES.
Comentarios
El controlador de minipuerto debe establecer incondicionalmente todos los contadores de la estructura DOT11_STATISTICS en cero, incluidos los contadores de capa MAC y PHY, cuando se produce uno de los siguientes:
- Se llama a la función MiniportInitializeEx del controlador.
- Se llama a la función MiniportOidRequest del controlador con una solicitud de conjunto de OID de OID_DOT11_RESET_REQUEST, independientemente del tipo de operación de restablecimiento especificada en la solicitud set.
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) |