DOT11EXTIHV_PERFORM_CAPABILITY_MATCH fungsi panggilan balik (wlanihv.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.

Sistem operasi memanggil fungsi Dot11ExtIhvPerformCapabilityMatch untuk meminta agar DLL Ekstensi IHV menentukan apakah jaringan set layanan dasar (BSS) yang terdeteksi cocok dengan ekstensi profil konektivitas dan keamanan yang ditentukan oleh IHV.

Sintaks

DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Dot11extihvPerformCapabilityMatch;

DWORD Dot11extihvPerformCapabilityMatch(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

Parameter

[in, optional] hIhvExtAdapter

Handel yang digunakan oleh DLL Ekstensi IHV untuk mereferensikan adaptor LAN nirkabel (WLAN). Nilai handel ini ditentukan melalui panggilan sebelumnya ke fungsi Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] pIhvProfileParams

Penunjuk ke DOT11EXT_IHV_PROFILE_PARAMS struktur. Struktur ini mendefinisikan atribut jaringan set layanan dasar (BSS) tempat ekstensi profil akan diterapkan.

[in] pIhvConnProfile

Penunjuk ke DOT11EXT_IHV_CONNECTIVITY_PROFILE struktur yang berisi pengaturan konektivitas untuk profil IHV.

[in] pIhvSecProfile

Penunjuk ke DOT11EXT_IHV_SECURITY_PROFILE struktur yang berisi pengaturan keamanan untuk profil IHV.

[in, optional] pConnectableBssid

Penunjuk ke struktur DOT11_BSS_LIST , yang berisi satu atau beberapa bingkai Beacon atau Probe Response 802.11 yang diterima dari jaringan BSS. Daftar ini berasal dari hasil operasi pemindaian terakhir yang dilakukan oleh adaptor WLAN. Untuk informasi selengkapnya tentang operasi pemindaian, lihat Operasi Pemindaian Asli 802.11.

Catatan Untuk Windows Vista, DLL Ekstensi IHV hanya mendukung jaringan set layanan dasar infrastruktur (BSS).

[out] pdwReasonCode

Penunjuk ke nilai DWORD, yang menyediakan informasi tambahan untuk nilai pengembalian fungsi Dot11ExtIhvPerformCapabilityMatch . DLL Ekstensi IHV harus mengatur * pdwReasonCode ke nilai L2_REASON_CODE_xxxx, yang ditentukan dalam L2cmn.h.

Nilai kembali

Jika semua entri dalam daftar bingkai Respons Suar dan Probe 802.11 mendukung atribut konektivitas dan keamanan yang ditentukan dalam fragmen profil, fungsi mengembalikan ERROR_SUCCESS. Jika tidak, ia mengembalikan kode kesalahan yang ditentukan dalam Winerror.h.

Keterangan

Setelah adaptor WLAN menyelesaikan operasi pemindaian untuk mendeteksi jaringan BSS dalam jangkauan, sistem operasi mungkin memanggil fungsi Dot11ExtIhvPerformCapabilityMatch untuk menentukan apakah salah satu jaringan BSS yang terdeteksi cocok dengan konektivitas atau ekstensi profil keamanan yang ditentukan oleh IHV.

Ketika fungsi Dot11ExtIhvPerformCapabilityMatch dipanggil, DLL Ekstensi IHV harus mengikuti panduan ini.

Jika DLL Ekstensi IHV menemukan setidaknya satu bingkai IEEE 802.11 Beacon atau Probe Response yang cocok dengan fragmen profil, ia harus mengatur * pdwReasonCode ke salah satu hal berikut:
- L2_REASON_CODE_SUCCESS.
- Nilai yang ditentukan IHV dalam rentang dari L2_REASON_CODE_IHV_BASE hingga (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
Dalam situasi ini, fungsi Dot11ExtIhvPerformCapabilityMatch harus mengembalikan ERROR_SUCCESS.
Jika DLL Ekstensi IHV tidak menemukan bingkai IEEE 802.11 Beacon atau Probe Response yang cocok dengan fragmen profil, itu tidak boleh mengatur *pdwReasonCode ke L2_REASON_CODE_SUCCESS. Sebagai gantinya, DLL harus mengatur * pdwReasonCode ke salah satu hal berikut ini:
- Nilai kesalahan L2_REASON_CODE_xxxx yang sesuai.
- Nilai yang ditentukan IHV dalam rentang dari L2_REASON_CODE_IHV_BASE hingga (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
Dalam situasi ini, fungsi Dot11ExtIhvPerformCapabilityMatch tidak boleh mengembalikan ERROR_SUCCESS.

Untuk informasi selengkapnya tentang skema XML Native 802.11, lihat dokumentasi Microsoft Windows SDK.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	wlanihv.h (termasuk Wlanihv.h, Winclient.h, L2cmn.h)