estructura DOT11_EXTSTA_SEND_CONTEXT (windot11.h)

Artículo
03/05/2024

Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.

La estructura de DOT11_EXTSTA_SEND_CONTEXT define los atributos Native 802.11 de un paquete que va a enviar el controlador de minipuerto que opera en modo 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 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.

El controlador de minipuerto debe producir un error en la solicitud de envío si el PHY especificado por uPhyId no es compatible o se ha deshabilitado a través de un mecanismo propietario implementado por el proveedor de hardware independiente (IHV). En esta situación, el controlador de minipuerto establece el miembro Status de la estructura NET_BUFFER_LIST en NDIS_STATUS_UNSUPPORTED_MEDIA y llama a NdisMSendNetBufferListsComplete para completar la solicitud de envío.

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.

La estación 802.11 usa el valor de uDelayedSleepValue para optimizar el rendimiento de red mientras funciona en modo PS. Por ejemplo, dependiendo del modo PS, la estación 802.11 podría mantener activada la radio después de la transmisión del paquete si uDelayedSleepValue es pequeña. Al hacerlo, la latencia de red se reducirá para recibir la respuesta.

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.

Para obtener más información sobre las operaciones de envío de Native 802.11, consulte Operaciones de envío nativas 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)