struktur DOT11_AUTH_CIPHER_PAIR_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_AUTH_CIPHER_PAIR_LIST mendefinisikan daftar struktur DOT11_AUTH_CIPHER_PAIR.

Sintaks

typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;

Anggota

Header

Jenis, revisi, dan ukuran struktur DOT11_AUTH_CIPHER_PAIR_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_AUTH_CIPHER_PAIR_LIST_REVISION_1.

Ukuran

Anggota ini harus diatur ke sizeof(DOT11_AUTH_CIPHER_PAIR_LIST).

Untuk informasi selengkapnya tentang anggota ini, lihat NDIS_OBJECT_HEADER.

uNumOfEntries

Jumlah entri dalam array AuthCipherPairs .

uTotalNumOfEntries

Jumlah maksimum entri yang dapat dimuat oleh array AuthCipherPairs .

AuthCipherPairs[1]

Daftar DOT11_AUTH_CIPHER_PAIR struktur.

Keterangan

Driver miniport mengembalikan struktur DOT11_AUTH_CIPHER_PAIR_LIST saat dikueri oleh salah satu 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_AUTH_CIPHER_PAIR_LIST, termasuk semua entri dalam array AuthCipherPairs. 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_AUTH_CIPHER_PAIR_LIST, driver miniport harus melakukan hal berikut:
- Untuk parameter OidRequest , atur anggota BytesWritten ke nol dan anggota BytesNeeded panjangnya, dalam byte, dari seluruh struktur DOT11_AUTH_CIPHER_PAIR_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_AUTH_CIPHER_PAIR_LIST, driver miniport harus melakukan hal berikut untuk menyelesaikan permintaan kueri yang berhasil:
- Untuk struktur DOT11_AUTH_CIPHER_PAIR_LIST, atur anggota uNumOfEntries dan uTotalNumOfEntries ke jumlah total entri dalam array AuthCipherPairs .
- Untuk parameter OidRequest , atur anggota BytesNeeded ke nol dan anggota BytesWritten panjangnya, dalam byte, dari seluruh struktur DOT11_AUTH_CIPHER_PAIR_LIST. Driver miniport juga harus menyalin seluruh struktur DOT11_AUTH_CIPHER_PAIR_LIST ke anggota InformationBuffer .
- Mengembalikan NDIS_STATUS_SUCCESS dari fungsi MiniportOidRequest-nya .

Dimulai dengan Windows 7, driver miniport 802.11 dapat melaporkan kombinasi pasangan algoritma autentikasi dan sandi yang didukung dalam DOT11_AUTH_CIPHER_PAIR_LIST. Namun, jika sistem operasi memulai Soft AP, sistem operasi hanya memungkinkan algoritma autentikasi DOT11_AUTH_ALGO_RSNA_PSK dan algoritma sandi DOT11_CIPHER_ALGO_CCMP . Untuk mendukung Soft AP, driver miniport harus mendukung pasangan autentikasi/cipher ini.

Jika WPS diaktifkan pada NIC yang beroperasi dalam mode Extensible AP, driver miniport harus mengizinkan stasiun serekan untuk mengaitkan dengan Extensible AP dengan menggunakan algoritma Open System Authentication atau Wired Equivalent Privacy (WEP ), terlepas dari algoritma otorisasi dan cipher yang diaktifkan. Untuk informasi selengkapnya tentang WPS dan Extensible AP, lihat OID_DOT11_WPS_ENABLED.

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

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER

Share via