struktur DOT11_EXTSTA_RECV_CONTEXT (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_EXTSTA_RECV_CONTEXT mendefinisikan atribut Native 802.11 dari paket yang diterima oleh stasiun 802.11 dan ditunjukkan oleh pengemudi miniport yang beroperasi dalam mode Extensible Station (ExtSTA) atau Network Monitor (NetMon). Untuk informasi selengkapnya tentang mode operasi ini, lihat Mode Operasi Native 802.11.

Sintaks

typedef struct DOT11_EXTSTA_RECV_CONTEXT {
  NDIS_OBJECT_HEADER Header;
  ULONG              uReceiveFlags;
  ULONG              uPhyId;
  ULONG              uChCenterFrequency;
  USHORT             usNumberOfMPDUsReceived;
  LONG               lRSSI;
  UCHAR              ucDataRate;
  ULONG              uSizeMediaSpecificInfo;
  PVOID              pvMediaSpecificInfo;
  ULONGLONG          ullTimestamp;
} DOT11_EXTSTA_RECV_CONTEXT, *PDOT11_EXTSTA_RECV_CONTEXT;

Anggota

Header

Jenis, revisi, dan ukuran struktur DOT11_EXTSTA_RECV_CONTEXT. 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_EXTSTA_RECV_CONTEXT_REVISION_1.

Ukuran

Anggota ini harus diatur ke sizeof(DOT11_EXTSTA_RECV_CONTEXT).

Untuk informasi selengkapnya tentang anggota ini, lihat NDIS_OBJECT_HEADER.

uReceiveFlags

Atribut data paket yang diterima ditentukan melalui bitmask.

Jika driver miniport beroperasi dalam mode ExtSTA, driver harus selalu mengatur uReceiveFlags ke nol.

Nilai bendera berikut berlaku untuk driver miniport jika beroperasi dalam mode NetMon.

DOT11_RECV_FLAG_RAW_PACKET

Jika bit ini diatur, paket berisi data seperti yang awalnya diterima oleh stasiun 802.11. Untuk informasi selengkapnya tentang paket mentah, lihat Menunjukkan Paket Raw 802.11.

DOT11_RECV_FLAG_RAW_PACKET_FCS_FAILURE

Jika bit ini diatur, data paket mentah diterima dengan kegagalan urutan pemeriksaan bingkai (FCS).

Catatan Driver miniport harus mengatur DOT11_RECV_FLAG_RAW_PACKET saat mengatur DOT11_RECV_FLAG_RAW_PACKET_FCS_FAILURE.

DOT11_RECV_FLAG_RAW_PACKET_TIMESTAMP

Jika bit ini diatur, NIC mengatur informasi tanda waktu di anggota ullTimestamp .

uPhyId

Pengidentifikasi (ID) PHY tempat stasiun 802.11 menerima paket.

uChCenterFrequency

Frekuensi pusat saluran, dalam satuan megahertz (MHz), dari pita frekuensi tempat stasiun 802.11 menerima paket.

usNumberOfMPDUsReceived

Jumlah fragmen unit data protokol kontrol akses media (MAC) (MPDU) yang diterima dan disusun ulang oleh stasiun 802.11 untuk paket. Nilai usNumberOfMPDUsReceived harus dari satu hingga nilai DOT11_MAX_NUM_OF_FRAGMENTS.

lRSSI

Nilai indikasi kekuatan sinyal yang diterima (RSSI) untuk fragmen MPDU terakhir yang diterima dari paket 802,11. Nilai RSSI berada dalam satuan desibel yang dirujuk ke 1,0 miliwatt (dBm).

ucDataRate

Tingkat data di mana stasiun 802.11 menerima paket. Nilai ucDataRate adalah nilai anggota ucDataRateIndex dari tingkat data dari tabel pemetaan tingkat data stasiun 802.11. Untuk informasi selengkapnya tentang tabel pemetaan laju data, lihat OID_DOT11_DATA_RATE_MAPPING_TABLE.

uSizeMediaSpecificInfo

Ukuran, dalam byte, dari informasi spesifik media di anggota pvMediaSpecificInfo . uSizeMediaSpecificInfo mendukung penyalinan informasi khusus media dan meneruskannya ke ekstensi IHV.

Catatan Anggota ini saat ini dicadangkan untuk digunakan di masa mendatang dan harus berisi nol.

pvMediaSpecificInfo

Penunjuk ke buffer yang berisi informasi khusus media. Driver miniport dapat mengatur anggota ini jika driver miniport meneruskan data OOB khusus media ke driver protokol khusus IHV 802.3.

Kerangka kerja 802.11 asli menyalin penunjuk ini ke entri MediaSpecificInformation di anggota NetBufferListInfo dari struktur NET_BUFFER_LIST 802.3 di NDIS menerima indikasi.

Catatan Ekstensi IHV saat ini tidak dapat menerima MediaSpecificInformation.

ullTimestamp

Nilai timer fungsi sinkronisasi waktu (TSF) 802.11, dalam mikrodetik, yang menentukan waktu ketika paket diterima. Anggota ini disediakan untuk mendukung yang menunjukkan paket mentah 802.11.

Jika NIC tidak mendukung ullTimestamp, NIC tidak boleh mengatur bendera DOT11_RECV_FLAG_RAW_PACKET_TIMESTAMP di anggota uReceiveFlags .

Keterangan

Saat melakukan operasi penerimaan Native 802.11, driver miniport harus memformat setiap paket 802.11 yang diterima sebagai struktur NET_BUFFER_LIST , dengan data paket yang diformat sebagai struktur NET_BUFFER dan ditautkan ke struktur NET_BUFFER_LIST. Setiap struktur NET_BUFFER_LIST harus menyertakan data out-of-band (OOB). Data OOB menentukan atribut paket yang diterima yang khusus untuk media LAN nirkabel (WLAN).

Driver miniport mengakses data OOB Native 802.11 melalui makro NET_BUFFER_LIST_INFO dengan parameter berikut:

Parameter _NBL , yang diteruskan penunjuk ke struktur NET_BUFFER_LIST yang digunakan untuk paket 802.11 yang diterima.
Parameter _ id , yang melewati nilai pengidentifikasi (ID) MediaSpecificInformation.

Jika driver miniport menetapkan DOT11_RECV_FLAG_RAW_PACKET di anggota uReceiveFlags , driver harus mengikuti panduan ini saat menyiapkan struktur DOT11_EXTSTA_RECV_CONTEXT:

Atur nilai usNumberOfMPDUsReceived menjadi satu.
Tetapkan nilai lRSSI ke nilai RSSI untuk paket mentah itu sendiri.
Tetapkan nilai ucDataRate ke nilai ucDataRateIndex untuk paket mentah itu sendiri.
Tetapkan nilai ucRSSI ke nilai RSSI yang dinormalisasi untuk paket mentah itu sendiri.

Untuk informasi selengkapnya tentang paket mentah, lihat Menunjukkan Paket Raw 802.11.

Untuk informasi selengkapnya tentang operasi penerima native 802.11, lihat Operasi Penerimaan Native 802.11.