struktur DOT11_SUPPORTED_ANTENNA_LIST (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_SUPPORTED_ANTENNA_LIST menentukan daftar antena yang dapat digunakan untuk menerima atau mengirimkan operasi.

Sintaks

typedef struct _DOT11_SUPPORTED_ANTENNA_LIST {
  ULONG                   uNumOfEntries;
  ULONG                   uTotalNumOfEntries;
  DOT11_SUPPORTED_ANTENNA dot11SupportedAntenna[1];
} DOT11_SUPPORTED_ANTENNA_LIST, *PDOT11_SUPPORTED_ANTENNA_LIST;

Anggota

uNumOfEntries

Jumlah entri dalam array dot11SupportedAntenna . Nilai nol untuk anggota uNumOfEntries menunjukkan daftar kosong.

uTotalNumOfEntries

Jumlah maksimum entri yang dapat dimuat oleh array dot11SupportedAntenna .

dot11SupportedAntenna[1]

Daftar antena yang didukung. Setiap elemen dalam daftar ini diformat sebagai DOT11_SUPPORTED_ANTENNA struktur.

Keterangan

Driver miniport mengembalikan struktur DOT11_SUPPORTED_ANTENNA_LIST saat dikueri oleh salah satu OID_DOT11_SUPPORTED_RX_ANTENNA atau OID_DOT11_SUPPORTED_TX_ANTENNA.

Ketika OID ini dikueri, driver miniport harus memverifikasi bahwa anggota InformationBuffer dari parameter OidRequest fungsi MiniportOidRequest cukup besar untuk mengembalikan seluruh struktur DOT11_SUPPORTED_ANTENNA_LIST, termasuk semua entri dalam array dot11SupportedAntenna. Nilai anggota InformationBufferLength dari parameter OidRequest menentukan apa yang harus dilakukan driver miniport, seperti yang ditunjukkan oleh daftar berikut:

Jika nilai anggota InformationBufferLength kurang dari panjang, dalam byte, dari seluruh struktur DOT11_SUPPORTED_ANTENNA_LIST, driver miniport harus melakukan hal berikut:
- Atur anggota uNumOfEntries ke nol.
- Atur anggota uTotalNumOfEntries ke jumlah entri dalam array dot11SupportedAntenna .
  Untuk parameter OidRequest , atur anggota BytesWritten ke nol dan anggota BytesNeeded panjangnya, dalam byte, dari seluruh struktur DOT11_PHY_ID_LIST.
- Gagalkan permintaan kueri dengan mengembalikan NDIS_STATUS_BUFFER_OVERFLOW dari fungsi MiniportOidRequest-nya .
Jika nilai anggota InformationBufferLength lebih besar dari atau sama dengan panjangnya, dalam byte, dari seluruh struktur DOT11_SUPPORTED_ANTENNA_LIST, driver miniport harus melakukan hal berikut untuk menyelesaikan permintaan kueri yang berhasil:
- Untuk struktur DOT11_SUPPORTED_ANTENNA_LIST, atur anggota uNumOfEntries dan uTotalNumOfEntries ke jumlah total entri dalam array dot11SupportedAntenna .
- Untuk parameter OidRequest , atur anggota BytesNeeded ke nol dan anggota BytesWritten panjangnya, dalam byte, dari seluruh struktur DOT11_SUPPORTED_ANTENNA_LIST. Driver miniport juga harus menyalin seluruh struktur DOT11_SUPPORTED_ANTENNA_LIST ke anggota InformationBuffer .
- Mengembalikan NDIS_STATUS_SUCCESS dari fungsi MiniportOidRequest-nya .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header	windot11.h (termasuk Ndis.h)

Lihat juga

DOT11_SUPPORTED_ANTENNA

OID_DOT11_SUPPORTED_TX_ANTENNA

OID_DOT11_SUPPORTED_RX_ANTENNA

Share via