estructura DOT11_EXTSTA_SEND_CONTEXT (windot11.h)
Importante
WiFiCx es el nuevo modelo de controlador de Wi-Fi lanzado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes. El modelo de controlador WDI ahora está en modo de mantenimiento y solo recibirá correcciones de prioridad alta.
La estructura DOT11_EXTSTA_SEND_CONTEXT define los atributos Native 802.11 de un paquete que el controlador de miniporte funciona en el modo de estación extensible (ExtSTA). Para obtener más información sobre este modo de operación, vea modo de operación de estación extensible.
Sintaxis
typedef struct DOT11_EXTSTA_SEND_CONTEXT {
NDIS_OBJECT_HEADER Header;
USHORT usExemptionActionType;
ULONG uPhyId;
ULONG uDelayedSleepValue;
PVOID pvMediaSpecificInfo;
ULONG uSendFlags;
} DOT11_EXTSTA_SEND_CONTEXT, *PDOT11_EXTSTA_SEND_CONTEXT;
Miembros
Header
Tipo, revisión y tamaño de la estructura DOT11_EXTSTA_SEND_CONTEXT. 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_EXTSTA_SEND_CONTEXT_REVISION_1.
Tamaño
Este miembro debe establecerse en sizeof(DOT11_EXTSTA_SEND_CONTEXT).
Para obtener más información sobre estos miembros, vea NDIS_OBJECT_HEADER.
usExemptionActionType
Tipo de exención de cifrado para el paquete. Se definen los siguientes tipos de exención:
DOT11_EXEMPT_NO_EXEMPTION
El paquete no está exento de ninguna operación de cifrado realizada por la estación 802.11.
DOT11_EXEMPT_ALWAYS
El paquete está exento de cualquier operación de cifrado realizada por la estación 802.11. La estación 802.11 debe transmitir el paquete sin cifrar.
DOT11_EXEMPT_ON_KEY_MAPPING_KEY_UNAVAILABLE
El paquete está exento de las operaciones de cifrado realizadas por la estación 802.11 solo si la estación no tiene una clave de asignación de claves para la dirección de control de acceso multimedia (MAC) de destino del paquete. Para obtener más información sobre las claves de asignación de claves, vea 802.11 Tipos de claves de cifrado.
uPhyId
Identificador (ID) de un tipo PHY en la estación 802.11. La estación 802.11 debe utilizar el PHY especificado para transmitir el paquete.
El valor de uPhyId debe ser uno de los siguientes:
- Valor de una entrada en la lista de tipos PHY activos definidos por el objeto msDot11ActivePhyList . El controlador de miniporta establece este objeto MIB en la lista de PHY que se han activado para su uso a través de la conexión de red del conjunto de servicios básico (BSS) actual. Para obtener más información sobre el objeto msDot11ActivePhyList MIB, vea OID_DOT11_ACTIVE_PHY_LIST.
- El valor de DOT11_PHY_ID_ANY, en cuyo caso la estación 802.11 puede usar cualquier PHY de la lista de PHY activos definidos por el msDot11ActivePhyList objeto MIB.
uDelayedSleepValue
Tiempo, en microsegundos, antes de que se espere una respuesta al paquete. El miembro uDelayedSleepValue solo es válido cuando se cumplen todas las siguientes condiciones:
- El paquete es un paquete de unidad de datos de servicio (MSDU) de control de acceso multimedia (MAC).
- La estación 802.11 funciona en modo de ahorro de energía (PS). En esta situación, el objeto Extensible Station (ExtSTA) msDot11PowerSavingLevel management information base (MIB) tiene cualquier valor excepto DOT11_POWER_SAVING_NO_POWER_SAVING. Para obtener más información sobre el valor de msDot11PowerSavingLevel MIB, consulte OID_DOT11_POWER_MGMT_REQUEST.
pvMediaSpecificInfo
Puntero a un búfer que contiene información específica del medio. Este miembro debe ser NULL cuando la estructura 802.11 NET_BUFFER_LIST a la que está asociada esta estructura procede del marco nativo 802.11 (incluidas las estructuras NET_BUFFER_LIST que proceden de una extensión IHV).
De lo contrario, pvMediaSpecificInfo apunta a los datos fuera de banda (OOB) asociados a la entrada MediaSpecificInformation en la netBufferListInfo miembro de la estructura original de NET_BUFFER_LIST 802.3. pvMediaSpecificInfo permite que el controlador de miniporte acceda a la información específica del medio desde un controlador de protocolo 802.3 específico de IHV.
uSendFlags
Conjunto de marcas que definen atributos de envío. Actualmente, no hay marcas definidas. Este miembro debe ser cero.
Observaciones
El controlador de miniporte realiza una operación de envío cuando su se llama a miniportSendNetBufferLists. Cada paquete pasado al controlador a través de esta función se define mediante una estructura de NET_BUFFER_LIST, que contiene datos nativos de 802.11 fuera de banda (OOB). Los datos de OOB contienen parámetros específicos de medios que usa la estación 802.11 al transmitir el paquete.
El controlador de miniporta accede a los datos OOB nativos 802.11 a través de la macro NET_BUFFER_LIST_INFO con los parámetros siguientes:
- Parámetro _NBL, que se pasa el puntero a la estructura NET_BUFFER_LIST usada para el paquete recibido 802.11.
- Parámetro _ id, que se pasa el valor de identificador (ID) de MediaSpecificInformation.
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) |