структура DOT11_EXTSTA_SEND_CONTEXT (windot11.h)

Статья
03/01/2024

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.

Структура DOT11_EXTSTA_SEND_CONTEXT определяет собственные атрибуты 802.11 пакета, который будет отправляться драйвером мини-порта, работающим в режиме ExtSTA. Дополнительные сведения об этом режиме работы см. в разделе Режим работы расширяемой станции.

Синтаксис

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;

Члены

Header

Тип, редакция и размер структуры DOT11_EXTSTA_SEND_CONTEXT. Этот элемент имеет формат структуры NDIS_OBJECT_HEADER .

Драйвер мини-порта должен задать для членов Header следующие значения:

Тип

Для этого элемента должно быть задано значение NDIS_OBJECT_TYPE_DEFAULT.

Редакция

Для этого элемента необходимо задать значение DOT11_EXTSTA_SEND_CONTEXT_REVISION_1.

Размер

Для этого элемента необходимо задать значение sizeof(DOT11_EXTSTA_SEND_CONTEXT).

Дополнительные сведения об этих членах см. в разделе NDIS_OBJECT_HEADER.

usExemptionActionType

Тип исключения шифрования для пакета. Определены следующие типы исключений:

DOT11_EXEMPT_NO_EXEMPTION

Пакет не исключается из любых операций шифрования, выполняемых станцией 802.11.

DOT11_EXEMPT_ALWAYS

Пакет исключается из всех операций шифра, выполняемых станцией 802.11. Станция 802.11 должна передавать пакет незашифрованным.

DOT11_EXEMPT_ON_KEY_MAPPING_KEY_UNAVAILABLE

Пакет исключается из любых операций шифрования, выполняемых станцией 802.11, только если у станции нет ключа сопоставления ключей для mac-адреса назначения пакета. Дополнительные сведения о ключах сопоставления ключей см. в разделе Типы ключей шифрования 802.11.

uPhyId

Идентификатор типа PHY на станции 802.11. Станция 802.11 должна использовать указанный PHY для передачи пакета.

Значение uPhyId должно иметь одно из следующих значений:

Значение записи в списке активных типов PHY, определенных объектом MIB msDot11ActivePhyList . Драйвер мини-порта задает этому объекту MIB список объектов PHY, которые были активированы для использования через текущее сетевое подключение базового набора служб (BSS). Дополнительные сведения об объекте MIB msDot11ActivePhyList см. в разделе OID_DOT11_ACTIVE_PHY_LIST.
Значение DOT11_PHY_ID_ANY. В этом случае станция 802.11 может использовать любой PHY из списка активных объектов PHY, определенных объектом MIB msDot11ActivePhyList .

Драйвер мини-порта должен не выполнить запрос на отправку, если PHY, заданный uPhyId , либо не поддерживается или был отключен с помощью защищенного механизма, реализованного независимым поставщиком оборудования (IHV). В этом случае драйвер мини-порта устанавливает для элемента Status структуры NET_BUFFER_LIST значение NDIS_STATUS_UNSUPPORTED_MEDIA и вызовов. NdisMSendNetBufferListsComplete для выполнения запроса на отправку.

uDelayedSleepValue

Время (в микросекундах) до получения ответа на пакет. Член uDelayedSleepValue действителен только в том случае, если выполняются все перечисленные ниже условия:

Пакет — это пакет MSDU службы управления доступом к мультимедиа (MAC).
Станция 802.11 работает в режиме экономии энергии (PS). В этом случае объект MIB (ExtSTA) msDot11PowerSavingLevel имеет любое значение, кроме DOT11_POWER_SAVING_NO_POWER_SAVING. Дополнительные сведения о значении MIB msDot11PowerSavingLevel см. в статье. OID_DOT11_POWER_MGMT_REQUEST.

Станция 802.11 использует значение uDelayedSleepValue для оптимизации производительности сети при работе в режиме PS. Например, в зависимости от режима PS станция 802.11 может поддерживать включение радиосвязи после передачи пакета, если uDelayedSleepValue имеет небольшой размер. Таким образом, задержка в сети будет уменьшена для получения ответа.

pvMediaSpecificInfo

Указатель на буфер, содержащий сведения, относящиеся к мультимедиа. Этот член должен иметь значение NULL , если NET_BUFFER_LIST структура 802.11, с которым связана эта структура, исходит от собственной платформы 802.11 (включая любые NET_BUFFER_LIST структуры, полученные из расширения IHV).

В противном случае pvMediaSpecificInfo указывает на внеполосные данные (OOB), связанные с записью MediaSpecificInformation в элементе NetBufferListInfo исходной структуры NET_BUFFER_LIST 802.3. pvMediaSpecificInfo позволяет драйверу мини-порта получать доступ к информации, относящейся к мультимедиа, из драйвера протокола IHV 802.3.

uSendFlags

Набор флагов, определяющих атрибуты отправки. В настоящее время флаги не определены. Этот элемент должен быть равен нулю.

Драйвер мини-порта выполняет операцию отправки, когда онВызывается MiniportSendNetBufferLists. Каждый пакет, передаваемый драйверу с помощью этой функции, определяется структурой NET_BUFFER_LIST , которая содержит собственные данные 802.11( OOB). Данные OOB содержат параметры мультимедиа, которые использует станция 802.11 при передаче пакета.

Драйвер мини-порта обращается к собственным данным OOB 802.11 через макрос NET_BUFFER_LIST_INFO со следующими параметрами:

Параметр _NBL , который передает указатель на структуру NET_BUFFER_LIST , используемую для полученного пакета 802.11.
Параметр _ id , который передает значение идентификатора (ID) объекта MediaSpecificInformation.

Дополнительные сведения об операциях отправки машинного кода 802.11 см. в разделе Собственные операции отправки 802.11.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть	windot11.h (включая Ndis.h)