struktur DOT11_PHY_ATTRIBUTES (windot11.h)

Artikel
08/08/2023

Penting Antarmuka LAN Nirkabel Native 802.11 tidak digunakan lagi di Windows 10 dan yang lebih baru. Silakan gunakan WLAN Device Driver Interface (WDI) sebagai gantinya. Untuk informasi selengkapnya tentang WDI, lihat WLAN Universal Windows driver model.

Struktur DOT11_PHY_ATTRIBUTES mendefinisikan atribut fisik dan operasi PHY pada stasiun 802.11.

Sintaks

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;

Anggota

Header

Jenis, revisi, dan ukuran struktur DOT11_PHY_ATTRIBUTES. Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Driver miniport harus mengatur anggota Header ke nilai berikut:

Jenis

Anggota ini harus diatur ke NDIS_OBJECT_TYPE_DEFAULT.

Revisi

Anggota ini harus diatur ke DOT11_PHY_ATTRIBUTES_REVISION_1.

Ukuran

Anggota ini harus diatur ke sizeof(DOT11_PHY_ATTRIBUTES).

Untuk informasi selengkapnya tentang anggota ini, lihat NDIS_OBJECT_HEADER.

PhyType

Jenis PHY seperti yang ditentukan oleh nilai enumerator DOT11_PHY_TYPE .

bHardwarePhyState

Nilai Boolean yang menentukan status daya perangkat keras PHY. Jika TRUE, status daya perangkat keras diaktifkan. Jika FALSE, status daya perangkat keras dinonaktifkan.

Untuk informasi selengkapnya tentang status daya perangkat keras PHY, lihat OID_DOT11_HARDWARE_PHY_STATE.

Catatan Setiap kali status daya perangkat keras PHY berubah, driver miniport harus NDIS_STATUS_DOT11_PHY_STATE_CHANGED indikasi status khusus media.

bSoftwarePhyState

Nilai Boolean yang menentukan status daya perangkat lunak PHY. Jika TRUE, status daya perangkat lunak diaktifkan. Jika FALSE, status daya perangkat lunak dinonaktifkan.

Untuk informasi selengkapnya tentang status daya perangkat lunak PHY, lihat OID_DOT11_NIC_POWER_STATE.

Catatan Setiap kali status daya perangkat lunak PHY berubah, driver miniport harus NDIS_STATUS_DOT11_PHY_STATE_CHANGED indikasi status khusus media.

bCFPollable

Nilai Boolean yang, jika diatur ke TRUE, menunjukkan bahwa stasiun 802.11 mendukung bingkai CF-Poll. Untuk informasi selengkapnya tentang bingkai CF-Poll, lihat Klausul 9.4 dari standar IEEE 802.11-2012.

Anggota ini tidak berlaku untuk mode operasi Extensible Access Point (ExtAP) dan diabaikan ketika NIC berada dalam mode ExtAP.

uMPDUMaxLength

Panjang maksimum, dalam byte, dari bingkai unit data protokol kontrol akses media (MAC) (MPDU) yang dapat ditransmisikan atau diterima PHY. Untuk informasi selengkapnya, lihat OID_DOT11_MPDU_MAX_LENGTH.

Catatan Setiap kali status daya perangkat lunak PHY berubah, driver miniport harus membuat indikasi status khusus media NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED.

TempType

Rentang suhu operasi PHY, didefinisikan melalui nilai enumerasi DOT11_TEMP_TYPE .

DiversitySupport

Jenis keragaman antena PHY, didefinisikan melalui nilai enumerasi DOT11_DIVERSITY_SUPPORT .

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

Atribut khusus PHY dari jenis PHY high-rate direct-sequence spread spectrum (HRDSS). Driver miniport harus menggunakan anggota ini hanya jika anggota PhyType diatur ke dot11_phy_type_hrdsss.

PhySpecificAttributes.OFDMAttributes

Atribut khusus PHY dari jenis PHY multiplexing divisi frekuensi ortogonal (OFDM). Driver miniport harus menggunakan anggota ini hanya jika anggota PhyType diatur ke dot11_phy_type_ofdm.

PhySpecificAttributes.ERPAttributes

Atribut khusus PHY dari jenis extended-rate PHY (ERP). Driver miniport harus menggunakan anggota ini hanya jika anggota PhyType diatur ke dot11_phy_type_erp.

Keterangan

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES struktur berisi anggota (pExtPhyAttributes) yang menentukan alamat array struktur DOT11_PHY_ATTRIBUTES. Ketika driver miniport memanggil NdisMSetMiniportAttributes, driver mengatur parameter MiniportAttributes ke alamat blok memori yang dialokasikan driver yang berisi struktur NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES bersama dengan array struktur DOT11_PHY_ATTRIBUTES.