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 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_STATISTICS_REVISION_1.
Tamaño
Este miembro debe establecerse en sizeof(DOT11_STATISTICS).
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 (WPA) 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 miniporte no debe escribir en este miembro.
MacUcastCounters
Los contadores de capas 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 estructura DOT11_MAC_FRAME_STATISTICS.
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 capas 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 estructura DOT11_MAC_FRAME_STATISTICS.
Los contadores de paquetes de multidifusión recibidos o de difusión 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, vea 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 miniport 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 miniport debe crear entradas independientes para cada uno.
Las entradas dentro de la matriz de PhyCounters deben estar en el mismo orden que la lista de PHY compatibles que devuelve el controlador cuando se consulta mediante OID_DOT11_SUPPORTED_PHY_TYPES.
Observaciones
El controlador de miniporte debe establecer incondicionalmente todos los contadores de la estructura de DOT11_STATISTICS en cero, incluidos los contadores de capa MAC y capa PHY, cuando se produce una de las siguientes acciones:
- Se llama a 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| encabezado de | windot11.h (incluye Ndis.h) |