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

Статья
02/27/2024

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

Структура DOT11_PHY_ATTRIBUTES определяет физические и рабочие атрибуты PHY на станции 802.11.

Синтаксис

typedef struct DOT11_PHY_ATTRIBUTES {
  NDIS_OBJECT_HEADER                  Header;
  DOT11_PHY_TYPE                      PhyType;
  BOOLEAN                             bHardwarePhyState;
  BOOLEAN                             bSoftwarePhyState;
  BOOLEAN                             bCFPollable;
  ULONG                               uMPDUMaxLength;
  DOT11_TEMP_TYPE                     TempType;
  DOT11_DIVERSITY_SUPPORT             DiversitySupport;
  union {
    DOT11_HRDSSS_PHY_ATTRIBUTES HRDSSSAttributes;
    DOT11_OFDM_PHY_ATTRIBUTES   OFDMAttributes;
    DOT11_ERP_PHY_ATTRIBUTES    ERPAttributes;
  };
  ULONG                               uNumberSupportedPowerLevels;
  ULONG                               TxPowerLevels[8];
  ULONG                               uNumDataRateMappingEntries;
  DOT11_DATA_RATE_MAPPING_ENTRY       DataRateMappingEntries[DOT11_RATE_SET_MAX_LENGTH];
  DOT11_SUPPORTED_DATA_RATES_VALUE_V2 SupportedDataRatesValue;
} DOT11_PHY_ATTRIBUTES, *PDOT11_PHY_ATTRIBUTES;

Члены

Header

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

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

Тип

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

Редакция

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

Размер

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

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

PhyType

Тип PHY, заданный значением перечислителя DOT11_PHY_TYPE .

bHardwarePhyState

Логическое значение, указывающее состояние питания оборудования PHY. Если задано значение TRUE, состояние питания оборудования включено. Если значение РАВНО FALSE, состояние питания оборудования отключено.

Дополнительные сведения о состоянии питания оборудования PHY см. в разделе OID_DOT11_HARDWARE_PHY_STATE.

Примечание Всякий раз, когда состояние питания оборудования PHY меняется, драйвер мини-порта должен сделать NDIS_STATUS_DOT11_PHY_STATE_CHANGED указание состояния для конкретного носителя.

bSoftwarePhyState

Логическое значение, указывающее состояние питания программного обеспечения PHY. Если задано значение TRUE, состояние питания программного обеспечения включено. При значении FALSE состояние питания программного обеспечения отключено.

Дополнительные сведения о состоянии питания программного обеспечения PHY см. в разделе OID_DOT11_NIC_POWER_STATE.

Примечание Всякий раз при изменении состояния питания программного обеспечения PHY драйвер мини-порта должен сделать NDIS_STATUS_DOT11_PHY_STATE_CHANGED указание состояния для конкретного носителя.

bCFPollable

Логическое значение, если задано значение TRUE, указывает, что станция 802.11 поддерживает CF-Poll кадры. Дополнительные сведения о CF-Poll кадрах см. в разделе 9.4 стандарта IEEE 802.11-2012.

Этот элемент не применяется к режиму работы extAP и игнорируется, когда сетевой адаптер находится в режиме ExtAP.

uMPDUMaxLength

Максимальная длина (в байтах) кадра mpdu ( в байтах) блока данных управления доступом к мультимедиа (MAC), который может передавать или получать PHY. Дополнительные сведения см. в разделе OID_DOT11_MPDU_MAX_LENGTH.

Примечание При изменении состояния питания программного обеспечения PHY драйвер мини-порта должен сделать NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED указание состояния конкретного носителя.

TempType

Диапазон рабочих температур PHY, определенный с помощью значения перечисления DOT11_TEMP_TYPE .

DiversitySupport

Тип разнообразия антенны PHY, определенный с помощью значения перечисления DOT11_DIVERSITY_SUPPORT .

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

Атрибуты, относящиеся к PHY типа PHY с высокой скоростью прямого спред-последовательность (HRDSS). Драйвер мини-порта должен использовать этот элемент только в том случае, если для элемента PhyType задано значение dot11_phy_type_hrdsss.

PhySpecificAttributes.OFDMAttributes

Атрибуты PHY, относящиеся к типу PHY с мультиплексированием ортогонального деления частоты (OFDM). Драйвер мини-порта должен использовать этот элемент только в том случае, если для элемента PhyType задано значение dot11_phy_type_ofdm.

PhySpecificAttributes.ERPAttributes

Зависящие от PHY атрибуты типа расширенной скорости PHY (ERP). Драйвер мини-порта должен использовать этот элемент только в том случае, если для элемента PhyType задано значение dot11_phy_type_erp.

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES структура содержит элемент (pExtPhyAttributes), указывающий адрес массива DOT11_PHY_ATTRIBUTES структур. Когда драйвер мини-порта вызывает NdisMSetMiniportAttributes, драйвер задает для параметра MiniportAttributes адрес выделенного драйвером блока памяти, который содержит структуру NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES вместе с массивом DOT11_PHY_ATTRIBUTES структуры.

Требования

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