estructura DOT11_EXTSTA_RECV_CONTEXT (windot11.h)
La estructura de DOT11_EXTSTA_RECV_CONTEXT define los atributos Native 802.11 de un paquete recibido por la estación 802.11 e indicado por el controlador de minipuerto que opera en modos extensible station (ExtSTA) o Network Monitor (NetMon). Para obtener más información sobre estos modos de operación, vea Native 802.11 Operation Modes.
Sintaxis
typedef struct DOT11_EXTSTA_RECV_CONTEXT {
NDIS_OBJECT_HEADER Header;
ULONG uReceiveFlags;
ULONG uPhyId;
ULONG uChCenterFrequency;
USHORT usNumberOfMPDUsReceived;
LONG lRSSI;
UCHAR ucDataRate;
ULONG uSizeMediaSpecificInfo;
PVOID pvMediaSpecificInfo;
ULONGLONG ullTimestamp;
} DOT11_EXTSTA_RECV_CONTEXT, *PDOT11_EXTSTA_RECV_CONTEXT;
Miembros
Header
Tipo, revisión y tamaño de la estructura DOT11_EXTSTA_RECV_CONTEXT. 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_EXTSTA_RECV_CONTEXT_REVISION_1.
Size
Este miembro debe establecerse sizeof(DOT11_EXTSTA_RECV_CONTEXT)en .
Para obtener más información sobre estos miembros, vea NDIS_OBJECT_HEADER.
uReceiveFlags
Atributos de los datos de paquete recibidos especificados a través de una máscara de bits.
Si el controlador de minipuerto funciona en modo ExtSTA, el controlador siempre debe establecer uReceiveFlags en cero.
Los siguientes valores de marca son válidos para el controlador de minipuerto si funciona en modo NetMon.
DOT11_RECV_FLAG_RAW_PACKET
Si se establece este bit, el paquete contiene los datos que recibió originalmente la estación 802.11. Para obtener más información sobre los paquetes sin procesar, vea Indicar paquetes sin procesar 802.11.
DOT11_RECV_FLAG_RAW_PACKET_FCS_FAILURE
Si se establece este bit, los datos de paquetes sin procesar se recibieron con errores de secuencia de comprobación de fotogramas (FCS).
DOT11_RECV_FLAG_RAW_PACKET_TIMESTAMP
Si se establece este bit, la NIC establece la información de marca de tiempo en el miembro ullTimestamp .
uPhyId
El identificador (ID) del PHY en el que la estación 802.11 recibió el paquete.
uChCenterFrequency
La frecuencia del centro del canal, en unidades de megahercios (MHz), de la banda de frecuencia en la que la estación 802.11 recibió el paquete.
usNumberOfMPDUsReceived
El número de fragmentos de unidad de datos de protocolo (MPDU) de control de acceso multimedia (MAC) recibidos y reensamblados por la estación 802.11 para el paquete. El valor de usNumberOfMPDUsReceived debe ser del uno al valor de DOT11_MAX_NUM_OF_FRAGMENTS.
lRSSI
Valor de indicación de intensidad de señal recibida (RSSI) para el último fragmento MPDU recibido del paquete 802.11. El valor RSSI está en unidades de decibelios a los que se hace referencia a 1,0 miliwatts (dBm).
ucDataRate
Velocidad de datos a la que la estación 802.11 recibió el paquete. El valor de ucDataRate es el valor del miembro ucDataRateIndex de la velocidad de datos de la tabla de asignación de velocidad de datos de la estación 802.11. Para más información sobre la tabla de asignación de velocidad de datos, consulte OID_DOT11_DATA_RATE_MAPPING_TABLE.
uSizeMediaSpecificInfo
Tamaño, en bytes, de la información específica del medio en el miembro pvMediaSpecificInfo . uSizeMediaSpecificInfo admite la copia de la información específica del medio y su paso a una extensión IHV.
pvMediaSpecificInfo
Puntero a un búfer que contiene información específica del medio. El controlador de minipuerto puede establecer este miembro si el controlador de minipuerto pasa datos OOB específicos del medio a un controlador de protocolo 802.3 específico de IHV.
El marco nativo 802.11 copia este puntero a la entrada MediaSpecificInformation en el miembro NetBufferListInfo de las estructuras de NET_BUFFER_LIST 802.3 en NDIS reciben indicaciones.
ullTimestamp
Valor del temporizador de la función de sincronización de tiempo (TSF) 802.11, en microsegundos, que especifica la hora en que se recibió el paquete. Este miembro se proporciona para admitir que indica paquetes 802.11 sin formato.
Si una NIC no admite ullTimestamp, no debe establecer la marca DOT11_RECV_FLAG_RAW_PACKET_TIMESTAMP en el miembro uReceiveFlags .
Comentarios
Al realizar una operación de recepción nativa 802.11, el controlador de minipuerto debe dar formato a cada paquete 802.11 como una estructura de NET_BUFFER_LIST , con los datos de paquete con formato de estructura NET_BUFFER y vinculados a la estructura de NET_BUFFER_LIST. Cada estructura de NET_BUFFER_LIST debe incluir datos fuera de banda (OOB). Los datos OOB especifican los atributos del paquete recibido que son específicos de los medios inalámbricos LAN (WLAN).
El controlador de minipuerto accede a los datos OOB nativos 802.11 a través de la macro NET_BUFFER_LIST_INFO con los parámetros siguientes:
- El parámetro _NBL , que se pasa el puntero a la estructura NET_BUFFER_LIST utilizada para el paquete 802.11 recibido.
- El parámetro _ id , que se pasa el valor de identificador (ID) de MediaSpecificInformation.
- Establezca el valor de usNumberOfMPDUsReceived en uno.
- Establezca el valor de lRSSI en el valor RSSI del propio paquete sin formato.
- Establezca el valor de ucDataRate en el valor ucDataRateIndex del propio paquete sin formato.
- Establezca el valor de ucRSSI en el valor RSSI normalizado para el propio paquete sin procesar.
Para obtener más información sobre las operaciones de recepción de Native 802.11, consulte Operaciones de recepción de Native 802.11.
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) |