структура DOT11_CIPHER_ALGORITHM_LIST (windot11.h)
Важно!
Собственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.
Структура DOT11_CIPHER_ALGORITHM_LIST определяет список DOT11_CIPHER_ALGORITHM структур, которые можно включить на станции 802.11.
Синтаксис
typedef struct DOT11_CIPHER_ALGORITHM_LIST {
NDIS_OBJECT_HEADER Header;
ULONG uNumOfEntries;
ULONG uTotalNumOfEntries;
DOT11_CIPHER_ALGORITHM AlgorithmIds[1];
} DOT11_CIPHER_ALGORITHM_LIST, *PDOT11_CIPHER_ALGORITHM_LIST;
Члены
Header
Тип, редакция и размер структуры DOT11_CIPHER_ALGORITHM_LIST. Этот элемент имеет формат структуры NDIS_OBJECT_HEADER .
Драйвер мини-порта должен задать для членов Header следующие значения:
Тип
Для этого элемента должно быть задано значение NDIS_OBJECT_TYPE_DEFAULT.
Редакция
Для этого элемента должно быть задано значение DOT11_CIPHER_ALGORITHM_LIST_REVISION_1.
Размер
Для этого элемента необходимо задать значение sizeof(DOT11_CIPHER_ALGORITHM_LIST).
Дополнительные сведения об этих членах см. в разделе NDIS_OBJECT_HEADER.
uNumOfEntries
Количество записей в массиве AlgorithmIds .
uTotalNumOfEntries
Максимальное количество записей, которые может содержать массив AlgorithmIds .
AlgorithmIds[1]
Алгоритм шифра, который определяется значением перечислителя DOT11_CIPHER_ALGORITHM .
Список алгоритмов шифрования отсортирован по предпочтениям. AlgorithmIds [0] определяет алгоритм шифра с наивысшим приоритетом.
Комментарии
Драйвер мини-порта возвращает структуру DOT11_CIPHER_ALGORITHM_LIST при запросе OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR или OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.
При запросе этих идентификаторов OID драйвер мини-порта должен убедиться, что член InformationBuffer параметра OidRequest функции MiniportOidRequest достаточно велик, чтобы вернуть всю структуру DOT11_CIPHER_ALGORITHM_LIST, включая все записи в массиве AlgorithmIds. Значение элемента InformationBufferLength параметра OidRequest определяет, что должен делать драйвер мини-порта, как показано в следующем списке:
- Если значение элемента InformationBufferLength меньше длины (в байтах) всей структуры DOT11_CIPHER_ALGORITHM_LIST, драйвер мини-порта должен сделать следующее:
- Для параметра OidRequest задайте для элемента BytesWritten значение 0, а для элемента BytesNeeded — длину всей структуры DOT11_CIPHER_ALGORITHM_LIST в байтах.
- Завершите запрос, возвращая NDIS_STATUS_BUFFER_OVERFLOW из функции MiniportOidRequest .
- Если значение элемента InformationBufferLength больше или равно длине (в байтах) всей структуры DOT11_CIPHER_ALGORITHM_LIST, драйвер мини-порта должен выполнить следующие действия для успешного выполнения запроса:
- Для структуры DOT11_CIPHER_ALGORITHM_LIST задайте для элементов uNumOfEntries и uTotalNumOfEntries общее количество записей в массиве AlgorithmIds .
- Для параметра OidRequest задайте для элемента BytesNeeded значение ноль, а для элемента BytesWritten — длину всей структуры DOT11_CIPHER_ALGORITHM_LIST в байтах. Драйвер мини-порта также должен скопировать всю структуру DOT11_CIPHER_ALGORITHM_LIST в элемент InformationBuffer .
- Возвращает NDIS_STATUS_SUCCESS из функции MiniportOidRequest .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно начиная с Windows Vista. |
| Верхняя часть | windot11.h (включая Ndis.h) |
См. также раздел
OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR