estructura DOT11_EXTSTA_SEND_CONTEXT (windot11.h)
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 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_SEND_CONTEXT_REVISION_1.
Size
Este miembro debe establecerse en sizeof(DOT11_EXTSTA_SEND_CONTEXT).
Para obtener más información sobre estos miembros, consulte 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 cualquier operación de cifrado realizada 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 clave 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 MIB msDot11ActivePhyList . El controlador de minipuerto 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 MIB msDot11ActivePhyList , 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 PHYs activos definidos por el objeto msDot11ActivePhyList 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 base de información de administración (MIB) de estación extensible (ExtSTA) msDot11PowerSavingLevel tiene cualquier valor excepto DOT11_POWER_SAVING_NO_POWER_SAVING. Para obtener más información sobre el valor msDot11PowerSavingLevel MIB, vea 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 propio 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 el miembro NetBufferListInfo de la estructura 802.3 original NET_BUFFER_LIST. 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.
Comentarios
El controlador de minipuerto realiza una operación de envío cuando suSe 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 minipuerto 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 utilizada para el paquete recibido 802.11.
- El parámetro _ id , que se pasa el valor de identificador (ID) de MediaSpecificInformation.
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) |