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

Статья
02/07/2025

Важный

WiFiCx — это новая модель драйвера Wi-Fi, выпущенная в Windows 11. Мы рекомендуем использовать WiFiCx для использования новейших функций. Модель драйвера WDI теперь находится в режиме обслуживания и получит только исправления с высоким приоритетом.

Структура 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.

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

Тип

Этот элемент должен иметь значение 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 структуры.

Замечания

Минипорт-драйвер возвращает структуру DOT11_AUTH_CIPHER_PAIR_LIST при запросе с помощью одного из следующих элементов. OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR или OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

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

Если значение элемента InformationBufferLeng th меньше длины в байтах всей структуры DOT11_AUTH_CIPHER_PAIR_LIST, драйвер минипорта должен выполнить следующее:
- Для параметра OidRequest задайте для элемента BytesWritten значение нулю, а элемент BytesNeed длину в байтах всей структуры 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 задайте для элемента BytesNeed равным нулю, а 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, минипорт-драйвер должен разрешить одноранговым станциям связаться с расширяемым AP с помощью Open System Authentication или Wired Equivalent Privacy (WEP) алгоритмов независимо от включенных алгоритмов авторизации и шифров. Дополнительные сведения о WPS и расширяемом AP см. в OID_DOT11_WPS_ENABLED.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
заголовка	windot11.h (include Ndis.h)

См. также

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER

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