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

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

Структура DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS указывает результаты операции сопоставления, выполняемой станцией 802.11 после получения запроса на связь от одноранговой станции в инфраструктуре BSS.

Синтаксис

typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  DOT11_MAC_ADDRESS      PeerMacAddr;
  ULONG                  uStatus;
  UCHAR                  ucErrorSource;
  BOOLEAN                bReAssocReq;
  BOOLEAN                bReAssocResp;
  ULONG                  uAssocReqOffset;
  ULONG                  uAssocReqSize;
  ULONG                  uAssocRespOffset;
  ULONG                  uAssocRespSize;
  DOT11_AUTH_ALGORITHM   AuthAlgo;
  DOT11_CIPHER_ALGORITHM UnicastCipher;
  DOT11_CIPHER_ALGORITHM MulticastCipher;
  ULONG                  uActivePhyListOffset;
  ULONG                  uActivePhyListSize;
  ULONG                  uBeaconOffset;
  ULONG                  uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;

Члены

Header

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

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

Тип

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

Редакция

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

Размер

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

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

PeerMacAddr

Mac-адрес одноранговой станции, отправляющей запрос на связь.

uStatus

Состояние связи с одноранговой станцией. Если значение равно нулю, связь завершается успешно. Если значение не равно нулям, связь завершается ошибкой.

ucErrorSource

Для ненулевых значений uStatus этот элемент указывает источник ошибки, препятствующей связыванию. Сетевой адаптер должен задать для ucErrorSource одно из следующих значений:

DOT11_ASSOC_ERROR_SOURCE_OS

Драйвер мини-порта отклонил процедуру сопоставления из-за системных ошибок, таких как ошибки нехватки памяти. В этом случае для uStatus следует задать NDIS_STATUS_XXX или NTSTATUS_XXX код, возвращаемый из операционной системы.

DOT11_ASSOC_ERROR_SOURCE_REMOTE

AP или одноранговая станция отклонили процедуру связи. В этом случае для uStatus должен быть задан код состояния 802.11, образующий кадр проверки подлинности 802.11, кадр ответа связи или кадр ответа повторной связи. Таблица 19 спецификации IEEE 802.11-2003 содержит все возможные значения. Драйвер мини-порта также может возвращать новые значения в этой спецификации IEEE при изменении.

DOT11_ASSOC_ERROR_SOURCE_OTHER

Сбой связи по определенной причине IHV. В этом случае uStatus содержит ненулевое значение, заданное IHV.

bReAssocReq

Логическое значение, указывающее, является ли запрос от одноранговой станции запросом на повторное связывание.

bReAssocResp

Логическое значение, указывающее, является ли ответ от сетевого адаптера запросом на повторную связь.

uAssocReqOffset

Смещение кадра запроса, используемого в операции сопоставления. Фрейм содержит информационные элементы (IEs), но не включает заголовок MAC 802.11.

uAssocReqSize

Длина (в байтах) кадра запроса, используемого в операции сопоставления. Фрейм содержит информационные элементы (IEs), но не включает заголовок MAC 802.11.

uAssocRespOffset

Смещение кадра ответа, используемого в операции сопоставления. Фрейм содержит информационные элементы (IEs), но не включает заголовок MAC 802.11.

uAssocRespSize

Длина кадра ответа (в байтах), используемого в операции связи. Фрейм содержит информационные элементы (IEs), но не включает заголовок MAC 802.11.

AuthAlgo

Алгоритм проверки подлинности, разрешенный станцией 802.11 с одноранговой станцией во время операции сопоставления. Дополнительные сведения о типе данных для элемента AuthAlgo см. в разделе DOT11_AUTH_ALGORITHM.

Примечание Драйвер мини-порта должен задать для этого элемента значение 0, если uStatus не имеет нулевого значения.

UnicastCipher

Алгоритм одноадресного шифрования, который станция 802.11 разрешила с одноранговой станцией во время операции связи. Дополнительные сведения о типе данных для элемента UnicastCipher см. в разделе DOT11_CIPHER_ALGORITHM.

Примечание Драйвер мини-порта должен задать для этого элемента значение 0, если uStatus не имеет нулевого значения.

MulticastCipher

Алгоритм многоадресного шифрования, который станция 802.11 разрешала с помощью точки доступа или одноранговой станции во время операции связи. Дополнительные сведения о типе данных для элемента MulticastCipher см. в разделе DOT11_CIPHER_ALGORITHM.

Примечание Драйвер мини-порта должен задать для этого элемента значение 0, если uStatus не имеет нулевого значения.

uActivePhyListOffset

Смещение списка идентификаторов PHY, которые станция 802.11 использует для отправки или получения пакетов в сетевом подключении BSS. Каждая запись является значением ULONG.

Объект Расширяемая станция (ExtSTA) msDot11ActivePhyList MIB также ссылается на активный список PHY.

Записи в списке активных PHY могут иметь одно из следующих значений:

  • Идентификатор PHY, заданный объектом MIB msDot11DesiredPhyList базы данных управления (ExtSTA). Дополнительные сведения об этом объекте MIB см. в разделе OID_DOT11_DESIRED_PHY_LIST.
  • Идентификатор PHY DOT11_PHY_ID_ANY. Драйвер мини-порта может задать для записи это значение, если объект ExtSTA msDot11ActivePhyList MIB указывает все идентификаторы PHY, указанные объектом MIB msDot11DesiredPhyList . Дополнительные сведения об этом объекте MIB см. в разделе OID_DOT11_ACTIVE_PHY_LIST.
    Примечание Запись со значением DOT11_PHY_ID_ANY должна быть единственной записью в активном списке PHY.
Смещение активного списка PHY относительно начала буфера, содержащего структуру DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Примечание Драйвер мини-порта должен задать для этого элемента значение 0, если uStatus не имеет нулевого значения.

uActivePhyListSize

Длина активного списка PHY (в байтах). Элемент uActivePhyListSize должен быть кратным sizeof(ULONG).

Примечание Драйвер мини-порта должен задать для этого элемента значение 0, если uStatus не имеет нулевого значения.

uBeaconOffset

Смещение (в байтах) последнего переданного кадра маяка 802.11.

Фрейм маяка включает заголовок рамки Маяка и все информационные элементы (IES), но не включает заголовок MAC 802.11. Формат рамки маяка определен в стандарте ISO/IEC 8802-11.

Кадр маяка должен быть последним кадром, используемым драйвером, за исключением того, что параметры реального времени или IES, которые зависят от управления потоком кадра данных или состоянием связи клиента, например метка времени, параметры радиосвязи, TIM, ERP и HT, не должны быть точными.

Примечание Драйвер мини-порта должен задать для этого элемента значение 0, если uStatus не имеет нулевого значения.

uBeaconSize

Длина (в байтах) последнего переданного кадра маяка 802.11.

Фрейм маяка включает заголовок рамки Маяка и все информационные элементы (IES), но не включает заголовок MAC 802.11. Формат рамки маяка определен в стандарте ISO/IEC 8802-11.

Кадр маяка должен быть последним кадром, используемым драйвером, за исключением того, что параметры реального времени или IES, которые зависят от управления потоком кадра данных или состоянием связи клиента, например метка времени, параметры радиосвязи, TIM, ERP и HT, не должны быть точными.

Примечание Драйвер мини-порта должен задать для этого элемента значение 0, если uStatus не имеет нулевого значения.

Комментарии

Драйвер минипорта Native 802.11 включает DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS структуру, когда драйвер создает NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION указание состояния.

Индикатор состояния NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION обозначает конец блока индикации связи. Если сопоставление выполнено успешно, сетевой адаптер должен сделать NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION указание после успешной отправки соответствующего кадра ответа связи на станцию, которая первоначально запросил связь. Если связь завершается сбоем, сетевой адаптер должен сделать NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION указывать, успешно ли отправлен ответ. Сбой может быть вызван тем, что сетевой адаптер или операционная система отклоняют запрос на связь или из-за сбоя, не связанного с платформой 802.11.

Требования

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

См. также раздел

DOT11_AUTH_ALGORITHM

NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION

DOT11_CIPHER_ALGORITHM

NDIS_OBJECT_HEADER