struktur DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS (windot11.h)

Artikel
03/05/2024

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_INCOMING_ASSOC_COMPLETION_PARAMETERS menentukan hasil operasi asosiasi yang dilakukan oleh stasiun 802.11 setelah menerima permintaan asosiasi dari stasiun serekan pada infrastruktur BSS.

Sintaks

typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  DOT11_MAC_ADDRESS      PeerMacAddr;
  ULONG                  uStatus;
  UCHAR                  ucErrorSource;
  BOOLEAN                bReAssocReq;
  BOOLEAN                bReAssocResp;
  ULONG                  uAssocReqOffset;
  ULONG                  uAssocReqSize;
  ULONG                  uAssocRespOffset;
  ULONG                  uAssocRespSize;
  DOT11_AUTH_ALGORITHM   AuthAlgo;
  DOT11_CIPHER_ALGORITHM UnicastCipher;
  DOT11_CIPHER_ALGORITHM MulticastCipher;
  ULONG                  uActivePhyListOffset;
  ULONG                  uActivePhyListSize;
  ULONG                  uBeaconOffset;
  ULONG                  uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;

Anggota

Header

Jenis, revisi, dan ukuran struktur DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS. 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_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1.

Ukuran

Anggota ini harus diatur ke sizeof(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS).

Untuk informasi selengkapnya tentang anggota ini, lihat NDIS_OBJECT_HEADER.

PeerMacAddr

Alamat kontrol akses media (MAC) stasiun serekan yang mengirim permintaan asosiasi.

uStatus

Status asosiasi dengan stasiun serekan. Jika nol, asosiasi berhasil. Jika bukan nol, asosiasi gagal.

ucErrorSource

Untuk nilai bukan nol uStatus, anggota ini menunjukkan sumber kesalahan yang mencegah asosiasi. NIC harus mengatur ucErrorSource ke salah satu nilai berikut:

DOT11_ASSOC_ERROR_SOURCE_OS

Driver miniport telah menolak prosedur asosiasi karena kesalahan sistem, seperti kesalahan kehabisan memori. Dalam hal ini, uStatus harus diatur ke kode NDIS_STATUS_XXX atau NTSTATUS_XXX yang dikembalikan dari sistem operasi.

DOT11_ASSOC_ERROR_SOURCE_REMOTE

AP atau stasiun serekan telah menolak prosedur asosiasi. Dalam hal ini, uStatus harus diatur ke kode status 802.11 membentuk bingkai autentikasi 802.11, bingkai respons asosiasi, atau bingkai respons asosiasi ulang. Tabel 19 dalam Spesifikasi IEEE 802.11-2003 berisi semua nilai yang mungkin. Driver miniport juga dapat mengembalikan nilai baru dalam spesifikasi IEEE ini ketika diubah.

DOT11_ASSOC_ERROR_SOURCE_OTHER

Asosiasi gagal karena alasan khusus IHV. Dalam hal ini, uStatus berisi nilai bukan nol yang ditentukan oleh IHV.

bReAssocReq

Nilai Boolean yang menunjukkan apakah permintaan dari stasiun serekan adalah permintaan asosiasi ulang.

bReAssocResp

Nilai Boolean yang menunjukkan apakah respons dari NIC adalah permintaan asosiasi ulang.

uAssocReqOffset

Offset bingkai permintaan yang digunakan dalam operasi asosiasi. Bingkai mencakup elemen informasi (IEs) tetapi tidak menyertakan header MAC 802.11.

uAssocReqSize

Panjangnya, dalam byte, dari bingkai permintaan yang digunakan dalam operasi asosiasi. Bingkai mencakup elemen informasi (IEs) tetapi tidak menyertakan header MAC 802.11.

uAssocRespOffset

Offset bingkai respons yang digunakan dalam operasi asosiasi. Bingkai mencakup elemen informasi (IEs) tetapi tidak menyertakan header MAC 802.11.

uAssocRespSize

Panjang bingkai respons, dalam byte, yang digunakan dalam operasi asosiasi. Bingkai mencakup elemen informasi (IEs) tetapi tidak menyertakan header MAC 802.11.

AuthAlgo

Algoritma autentikasi yang diselesaikan stasiun 802.11 dengan stasiun serekan selama operasi asosiasi. Untuk informasi selengkapnya tentang jenis data untuk anggota AuthAlgo , lihat DOT11_AUTH_ALGORITHM.

Catatan Driver miniport harus mengatur anggota ini ke nol jika uStatus tidak diatur ke nol.

UnicastCipher

Algoritma sandi unicast bahwa stasiun 802.11 diselesaikan dengan stasiun serekan selama operasi asosiasi. Untuk informasi selengkapnya tentang jenis data untuk anggota UnicastCipher , lihat DOT11_CIPHER_ALGORITHM.

Catatan Driver miniport harus mengatur anggota ini ke nol jika uStatus tidak diatur ke nol.

MulticastCipher

Algoritma sandi multicast bahwa stasiun 802.11 diselesaikan dengan AP atau stasiun serekan selama operasi asosiasi. Untuk informasi selengkapnya tentang jenis data untuk anggota MulticastCipher , lihat DOT11_CIPHER_ALGORITHM.

Catatan Driver miniport harus mengatur anggota ini ke nol jika uStatus tidak diatur ke nol.

uActivePhyListOffset

Offset daftar pengidentifikasi PHY (ID) yang digunakan stasiun 802.11 untuk mengirim atau menerima paket pada koneksi jaringan BSS. Setiap entri adalah nilai ULONG.

Extensible Station (ExtSTA) msDot11ActivePhyList MIB objec juga mereferensikan daftar PHY aktif.

Entri dalam daftar PHY aktif bisa menjadi salah satu nilai berikut:

ID PHY yang ditentukan oleh objek Extensible Station (ExtSTA) msDot11DesiredPhyList management information base (MIB). Untuk informasi selengkapnya tentang objek MIB ini, lihat OID_DOT11_DESIRED_PHY_LIST.
A PHY ID of DOT11_PHY_ID_ANY. Driver miniport dapat mengatur entri ke nilai ini jika objek ExtSTA msDot11ActivePhyList MIB menentukan semua ID PHY yang ditentukan oleh objek msDot11DesiredPhyList MIB. Untuk informasi selengkapnya tentang objek MIB ini, lihat OID_DOT11_ACTIVE_PHY_LIST.
Catatan Entri dengan nilai DOT11_PHY_ID_ANY harus menjadi satu-satunya entri dalam daftar PHY aktif.

Offset daftar PHY aktif relatif terhadap awal buffer yang berisi struktur DOT11_ASSOCIATION_COMPLETION_PARAMETERS.

Catatan Driver miniport harus mengatur anggota ini ke nol jika uStatus tidak diatur ke nol.

uActivePhyListSize

Panjangnya, dalam byte, dari daftar PHY aktif. Anggota uActivePhyListSize harus kelipatan .sizeof(ULONG)

Catatan Driver miniport harus mengatur anggota ini ke nol jika uStatus tidak diatur ke nol.

uBeaconOffset

Offset, dalam byte, dari bingkai Suar 802,11 terakhir yang ditransmisikan.

Bingkai Beacon menyertakan header bingkai Beacon dan semua elemen informasi (IEs), tetapi tidak menyertakan header MAC 802.11. Format bingkai Suar ditentukan dalam ISO/IEC 8802-11.

Bingkai Beacon harus menjadi bingkai terbaru yang digunakan oleh driver, kecuali bahwa parameter real-time atau IEs yang bervariasi dengan kontrol aliran bingkai data, atau status asosiasi klien seperti tanda waktu, parameter radio, TIM, ERP, dan IE HT, tidak perlu akurat,

Catatan Driver miniport harus mengatur anggota ini ke nol jika uStatus tidak diatur ke nol.

uBeaconSize

Panjangnya, dalam byte, dari bingkai Suar 802,11 terakhir yang ditransmisikan.

Bingkai Beacon menyertakan header bingkai Beacon dan semua elemen informasi (IEs), tetapi tidak menyertakan header MAC 802.11. Format bingkai Suar ditentukan dalam ISO/IEC 8802-11.

Catatan Driver miniport harus mengatur anggota ini ke nol jika uStatus tidak diatur ke nol.

Keterangan

Driver miniport Native 802.11 mencakup struktur DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS saat pengemudi NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indikasi status.

Indikasi status NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION menandai akhir blok indikasi asosiasi. Jika asosiasi berhasil, NIC harus membuat indikasi NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION setelah berhasil mengirim bingkai respons asosiasi yang sesuai ke stasiun yang awalnya meminta asosiasi. Jika asosiasi gagal, NIC harus membuat indikasi NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION apakah respons berhasil dikirim atau tidak. Kegagalannya bisa karena NIC atau sistem operasi menolak permintaan asosiasi atau karena kegagalan yang tidak terkait dengan kerangka kerja 802.11.