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

Статья
02/27/2024

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

Структура DOT11_AUTH_CIPHER_PAIR_LIST определяет список DOT11_AUTH_CIPHER_PAIR структур.

Синтаксис

typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;

Члены

Header

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

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

Тип

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

Редакция

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

Размер

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

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

uNumOfEntries

Количество записей в массиве AuthCipherPairs .

uTotalNumOfEntries

Максимальное количество записей, которые может содержать массив AuthCipherPairs .

AuthCipherPairs[1]

Список . DOT11_AUTH_CIPHER_PAIR структуры.

При запросе этих идентификаторов OID драйвер мини-порта должен убедиться, что элемент InformationBuffer параметра OidRequest функции MiniportOidRequest достаточно велик, чтобы вернуть всю структуру DOT11_AUTH_CIPHER_PAIR_LIST, включая все записи в массиве AuthCipherPairs. Значение элемента InformationBufferLength параметра OidRequest определяет, что должен делать драйвер мини-порта, как показано в следующем списке:

Если значение элемента InformationBufferLength меньше длины (в байтах) всей структуры DOT11_AUTH_CIPHER_PAIR_LIST, драйвер мини-порта должен выполнить следующие действия:
- Для параметра OidRequest задайте для элемента BytesWritten значение ноль, а для элемента BytesNeeded — длину всей структуры DOT11_AUTH_CIPHER_PAIR_LIST в байтах.
- Завершите запрос, возвращая NDIS_STATUS_BUFFER_OVERFLOW из функции MiniportOidRequest .
Если значение элемента InformationBufferLength больше или равно длине (в байтах) всей структуры DOT11_AUTH_CIPHER_PAIR_LIST, драйвер мини-порта должен выполнить следующие действия для успешного выполнения запроса:
- Для структуры DOT11_AUTH_CIPHER_PAIR_LIST задайте для элементов uNumOfEntries и uTotalNumOfEntries общее количество записей в массиве AuthCipherPairs .
- Для параметра OidRequest задайте для элемента BytesNeeded значение 0, а для элемента BytesWritten — длину всей структуры DOT11_AUTH_CIPHER_PAIR_LIST в байтах. Драйвер мини-порта также должен скопировать всю структуру DOT11_AUTH_CIPHER_PAIR_LIST в элемент InformationBuffer .
- Возвращает NDIS_STATUS_SUCCESS из функции MiniportOidRequest .

Начиная с Windows 7 драйвер мини-порта 802.11 может сообщать о любом сочетании поддерживаемых пар алгоритмов проверки подлинности и шифра в DOT11_AUTH_CIPHER_PAIR_LIST. Однако если операционная система запускает Soft AP, она включает только алгоритм проверки подлинности DOT11_AUTH_ALGO_RSNA_PSK и алгоритм шифрования DOT11_CIPHER_ALGO_CCMP . Для поддержки Soft AP драйвер мини-порта должен поддерживать эту пару проверки подлинности и шифра.

Если wps включена на сетевом адаптере, работающем в режиме расширяемой точки доступа, драйвер минипорта должен разрешить одноранговым станциям связываться с расширяемым AP с помощью алгоритмов проверки подлинности открытой системы или проводного эквивалента конфиденциальности (WEP), независимо от включенных алгоритмов авторизации и шифров. Дополнительные сведения о WPS и расширяемой точке доступа см. в разделе OID_DOT11_WPS_ENABLED.

Требования

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

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

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER

Поделиться через