struktur NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES (ndis.h)

Artikel
02/26/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 NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES mendefinisikan atribut fisik dan operasi driver miniport Native 802.11 dan stasiun 802.11.

Sintaks

typedef struct {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    OpModeCapability;
  ULONG                    NumOfTXBuffers;
  ULONG                    NumOfRXBuffers;
  BOOLEAN                  MultiDomainCapabilityImplemented;
  ULONG                    NumSupportedPhys;
  PDOT11_PHY_ATTRIBUTES    SupportedPhyAttributes;
  PDOT11_EXTSTA_ATTRIBUTES ExtSTAAttributes;
#if (NDIS_SUPPORT_NDIS620)
  PDOT11_VWIFI_ATTRIBUTES  VWiFiAttributes;
  PDOT11_EXTAP_ATTRIBUTES  ExtAPAttributes;
#endif
#if (NDIS_SUPPORT_NDIS630)
  PDOT11_WFD_ATTRIBUTES    WFDAttributes;
#endif
} NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES. 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_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES.

Revisi

Untuk sistem operasi Windows Vista atau Windows Server 2008, anggota ini harus diatur ke NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_1.

Untuk versi sistem operasi Windows yang lebih baru, anggota ini harus diatur ke NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_2.

Ukuran

Untuk sistem operasi Windows Vista atau Windows Server 2008, anggota ini harus diatur ke NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_1.

Untuk versi sistem operasi Windows yang lebih baru, anggota ini harus diatur ke NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_2.

Untuk informasi selengkapnya tentang anggota ini, lihat NDIS_OBJECT_HEADER.

OpModeCapability

Bitmask dari mode operasi yang didukung driver miniport. Bitmask ini didefinisikan melalui yang berikut:

DOT11_OPERATION_MODE_EXTENSIBLE_AP

Menentukan bahwa driver miniport mendukung mode operasi Extensible Access Point (ExtAP).

Nilai ini tersedia dimulai dengan Windows 7.

DOT11_OPERATION_MODE_EXTENSIBLE_STATION

Menentukan bahwa pengemudi miniport mendukung mode operasi Extensible Station (ExtSTA).

DOT11_OPERATION_MODE_NETWORK_MONITOR

Menentukan bahwa driver miniport mendukung mode operasi Monitor Jaringan (NetMon).

Untuk informasi selengkapnya tentang mode operasi, lihat Mode Operasi Native 802.11.

NumOfTXBuffers

Jumlah maksimum paket unit data layanan kontrol akses media (MAC) (MSDU) yang dapat ditahan stasiun 802.11 dalam antrean transmisinya. Driver miniport harus mendukung kedalaman antrean transmisi minimum 64.

Nilai anggota ini tidak boleh menyertakan jumlah buffer transmisi yang digunakan stasiun 802.11 untuk mengirim paket sendiri, seperti paket Beacon atau paket kontrol 802.11.

NumOfRXBuffers

Jumlah maksimum paket MSDU yang dapat di-buffer oleh stasiun 802.11 dalam antrean penerimanya. Driver miniport harus mendukung kedalaman antrean penerima minimum 64.

MultiDomainCapabilityImplemented

Nilai Boolean yang, jika TRUE, menentukan bahwa stasiun 802.11 dapat beroperasi di beberapa domain peraturan. Untuk informasi selengkapnya tentang domain peraturan 802.11, lihat standar IEEE 802.11d-2001.

NumSupportedPhys

Jumlah PHY di stasiun 802.11.

SupportedPhyAttributes

Penunjuk ke array struktur DOT11_PHY_ATTRIBUTES . Array ini harus memiliki entri NumSupportedPhys dan harus diurutkan dalam urutan yang sama dengan daftar tipe PHY yang dikembalikan melalui kueri OID_DOT11_SUPPORTED_PHY_TYPES.

ExtSTAAttributes

Pointer ke struktur DOT11_EXTSTA_ATTRIBUTES yang menentukan atribut driver miniport dan stasiun 802.11 saat beroperasi dalam mode Extensible Station (ExtSTA). Untuk informasi selengkapnya tentang mode operasi ini, lihat Mode Operasi Stasiun yang Dapat Diperluas.

VWiFiAttributes

Penunjuk ke struktur DOT11_VWIFI_ATTRIBUTES yang menentukan atribut driver miniport dan stasiun 802.11 saat beroperasi dalam mode WiFi Virtual.

Anggota ini tersedia dimulai dengan Windows 7.

ExtAPAttributes

Pointer ke struktur DOT11_EXTAP_ATTRIBUTES yang menentukan atribut driver miniport dan stasiun 802.11 saat beroperasi dalam mode Extensible Access Point (ExtAP).

Anggota ini tersedia dimulai dengan Windows 7.

WFDAttributes

Penunjuk ke struktur DOT11_WFD_ATTRIBUTES yang menentukan atribut driver miniport dan stasiun 802.11 saat beroperasi dalam mode Wi-Fi Direct (WFD).

Anggota ini tersedia dimulai dengan Windows 8.

Keterangan

Ketika fungsi MiniportInitializeEx dipanggil, driver miniport harus memanggil Fungsi NdisMSetMiniportAttributes untuk menentukan atribut Native 802.11 dari driver dan stasiun 802.11. Driver miniport harus mengikuti panduan ini ketika melakukan panggilan ke NdisMSetMiniportAttributes:

Parameter MiniportAttributes harus diatur ke alamat blok memori yang dialokasikan driver yang berisi struktur NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES bersama dengan atribut ExtSTA dan array atribut PHY.
Anggota SupportedPhyAttributes harus menjadi alamat array struktur DOT11_PHY_ATTRIBUTES . Array ini harus berada dalam blok memori yang dialokasikan driver yang dirujuk oleh parameter MiniportAttributes .
Anggota ExtSTAAttributes harus menjadi alamat struktur DOT11_EXTSTA_ATTRIBUTES . Struktur ini harus berada dalam blok memori yang dialokasikan driver yang dirujuk oleh parameter MiniportAttributes .