struktur DOT11_BYTE_ARRAY (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_BYTE_ARRAY mendahului daftar struktur panjang variabel di anggota InformationBuffer dari parameter OidRequest fungsi MiniportOidRequest.

Sintaks

typedef struct DOT11_BYTE_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfBytes;
  ULONG              uTotalNumOfBytes;
  UCHAR              ucBuffer[1];
} DOT11_BYTE_ARRAY, *PDOT11_BYTE_ARRAY;

Anggota

Header

Jenis, revisi, dan ukuran struktur DOT11_BYTE_ARRAY. 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 revisi struktur panjang variabel yang mengikuti struktur DOT11_BYTE_ARRAY. Untuk informasi selengkapnya tentang revisi struktur ini, lihat pengidentifikasi objek (OIDS) yang tercantum di bagian "Lihat Juga".

Ukuran

Anggota ini harus diatur ke sizeof(DOT11_BYTE_ARRAY).

Untuk informasi selengkapnya tentang anggota ini, lihat NDIS_OBJECT_HEADER.

uNumOfBytes

Jumlah byte dalam array ucBuffer .

uTotalNumOfBytes

Jumlah maksimum byte yang diperlukan array ucBuffer .

ucBuffer[1]

Daftar struktur panjang variabel.

Keterangan

Jenis struktur yang disimpan dalam array ucBuffer bergantung pada kumpulan OID dan permintaan kueri. Misalnya, ketika dikueri oleh OID_DOT11_ENUM_BSS_LIST, driver miniport menyimpan satu atau beberapa struktur DOT11_BSS_ENTRY dalam array ucBuffer .

Ketika dikueri oleh OID yang menggunakan struktur DOT11_BYTE_ARRAY, driver miniport harus memverifikasi bahwa anggota InformationBuffer dari parameter OidRequest fungsi MiniportOidRequest cukup besar untuk mengembalikan seluruh struktur, termasuk semua entri dalam array ucBuffer. 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_BYTE_ARRAY, 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_BYTE_ARRAY
- 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_BYTE_ARRAY, driver miniport harus melakukan hal berikut untuk menyelesaikan permintaan kueri yang berhasil:
- Untuk struktur DOT11_BYTE_ARRAY, atur anggota uNumOfBytes dan uTotalNumOfBytes ke jumlah total entri dalam array ucBuffer .
- Untuk parameter OidRequest , atur anggota BytesNeeded ke nol dan anggota BytesWritten ke panjang, dalam byte, dari seluruh struktur DOT11_BYTE_ARRAY. Driver miniport juga harus menyalin seluruh struktur DOT11_BYTE_ARRAY 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

OID_DOT11_CIPHER_KEY_MAPPING_KEY

OID_DOT11_ENUM_BSS_LIST

NDIS_OBJECT_HEADER

Share via