struktur DOT11_CIPHER_ALGORITHM_LIST (windot11.h)

Artikel
02/27/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_CIPHER_ALGORITHM_LIST mendefinisikan daftar struktur DOT11_CIPHER_ALGORITHM yang dapat diaktifkan pada stasiun 802.11.

Sintaks

typedef struct DOT11_CIPHER_ALGORITHM_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_CIPHER_ALGORITHM AlgorithmIds[1];
} DOT11_CIPHER_ALGORITHM_LIST, *PDOT11_CIPHER_ALGORITHM_LIST;

Anggota

Header

Jenis, revisi, dan ukuran struktur DOT11_CIPHER_ALGORITHM_LIST. 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_CIPHER_ALGORITHM_LIST_REVISION_1.

Ukuran

Anggota ini harus diatur ke sizeof(DOT11_CIPHER_ALGORITHM_LIST).

Untuk informasi selengkapnya tentang anggota ini, lihat NDIS_OBJECT_HEADER.

uNumOfEntries

Jumlah entri dalam array AlgorithmIds .

uTotalNumOfEntries

Jumlah maksimum entri yang dapat dimuat oleh array AlgorithmIds .

AlgorithmIds[1]

Algoritma sandi, yang didefinisikan oleh nilai enumerator DOT11_CIPHER_ALGORITHM .

Daftar algoritma sandi diurutkan menurut preferensi. AlgorithmIds [0] mendefinisikan algoritma cipher dengan preferensi tertinggi.

Keterangan

Driver miniport mengembalikan struktur DOT11_CIPHER_ALGORITHM_LIST saat dikueri oleh OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR atau OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Ketika OID ini dikueri, driver miniport harus memverifikasi bahwa anggota InformationBuffer dari parameter OidRequest fungsi MiniportOidRequest cukup besar untuk mengembalikan seluruh struktur DOT11_CIPHER_ALGORITHM_LIST, termasuk semua entri dalam array AlgorithmIds. 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_CIPHER_ALGORITHM_LIST, driver miniport harus melakukan hal berikut:
- Untuk parameter OidRequest , atur anggota BytesWritten ke nol dan anggota BytesNeeded ke panjang, dalam byte, dari seluruh struktur DOT11_CIPHER_ALGORITHM_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_CIPHER_ALGORITHM_LIST, driver miniport harus melakukan hal berikut untuk menyelesaikan permintaan kueri yang berhasil:
- Untuk struktur DOT11_CIPHER_ALGORITHM_LIST, atur anggota uNumOfEntries dan uTotalNumOfEntries ke jumlah total entri dalam array AlgorithmIds .
- Untuk parameter OidRequest , atur anggota BytesNeeded ke nol dan anggota BytesWritten ke panjang, dalam byte, dari seluruh struktur DOT11_CIPHER_ALGORITHM_LIST. Driver miniport juga harus menyalin seluruh struktur DOT11_CIPHER_ALGORITHM_LIST ke anggota InformationBuffer .
- Mengembalikan NDIS_STATUS_SUCCESS dari fungsi MiniportOidRequest-nya .