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

Статья
02/07/2025

Важный

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

Структура DOT11_PHY_ID_LIST указывает список нулевого или более типов PHY.

Синтаксис

typedef struct DOT11_PHY_ID_LIST {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfEntries;
  ULONG              uTotalNumOfEntries;
  ULONG              dot11PhyId[1];
} DOT11_PHY_ID_LIST, *PDOT11_PHY_ID_LIST;

Члены

Header

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

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

Тип

Этот элемент должен иметь значение NDIS_OBJECT_TYPE_DEFAULT.

Пересмотр

Этот элемент должен иметь значение DOT11_PHY_ID_LIST_REVISION_1.

Размер

Этот элемент должен иметь значение sizeof(DOT11_PHY_ID_LIST).

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

uNumOfEntries

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

uTotalNumOfEntries

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

dot11PhyId[1]

Список идентификаторов PHY (идентификаторов).

Замечания

Идентификатор PHY в массиве dot11PhyId должен быть одним из следующих элементов:

Индекс в таблицу поддерживаемых phYs, определенных объектом Native 802.11 Operations msDot11SupportedPhyTypes базой сведений об управлении (MIB). Дополнительные сведения об идентификаторах PHY и msDot11SupportedPhyTypes объект MIB см. в разделе OID_DOT11_SUPPORTED_PHY_TYPES.
Идентификатор PHY со значением DOT11_PHY_ID_ANY. Этот идентификатор PHY называется подстановочным знаком PHY и используется для указания любого поддерживаемого PHY на станции 802.11. Если используется идентификатор PHY с подстановочным знаком, он должен быть единственной записью в массиве dot11PhyId.

Мини-порт возвращает структуру DOT11_PHY_ID_LIST при запросе OID_DOT11_ACTIVE_PHY_LIST или OID_DOT11_DESIRED_PHY_LIST.

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

Если значение элемента InformationBufferLength меньше длины в байтах всей структуры DOT11_PHY_ID_LIST, драйвер минипорта должен выполнить следующее:
- Задайте для элемента uNumOfEntries значение нулю.
- Задайте элемент uTotalNumOfEntries число записей в массиве dot11PhyId.
- Для параметра OidRequest задайте для элемента BytesWritten равным нулю, а элемент BytesNeededed длину в байтах всей структуры DOT11_PHY_ID_LIST.
- Сбой запроса, возвращая NDIS_STATUS_BUFFER_OVERFLOW из функции MiniportOidRequest.
Если значение элемента InformationBufferLength больше или равно длине в байтах всей структуры DOT11_PHY_ID_LIST, драйвер минипорта должен выполнить следующие действия, чтобы завершить успешный запрос:
- Для структуры DOT11_PHY_ID_LIST задайте uNumOfEntries и элементов uTotalNumOfEntries общее количество записей в массиве dot11PhyId.
- Для параметра OidRequest задайте для элемента BytesNeed значение нулю, а элемент BytesWritten длину в байтах всей структуры DOT11_PHY_ID_LIST. Минипорт-драйвер также должен скопировать всю структуру DOT11_PHY_ID_LIST в элемент InformationBuffer.
- Возвращает NDIS_STATUS_SUCCESS из функции MiniportOidRequest.

Требования

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

См. также

OID_DOT11_ACTIVE_PHY_LIST

OID_DOT11_DESIRED_PHY_LIST

NDIS_OBJECT_HEADER

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