DOT11EXTIHV_QUERY_UI_REQUEST 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 Dot11ExtIhvQueryUIRequest setiap kali status koneksi berubah. Ketika fungsi ini dipanggil, DLL Ekstensi IHV mengembalikan struktur DOT11EXT_IHV_UI_REQUEST yang dapat digunakan sistem operasi untuk permintaan UI.

Sintaks

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

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 Handler IHV Dot11ExtIhvInitAdapter .

[in] connectionPhase

Fase koneksi saat ini. Jenis data untuk anggota ini adalah enumerasi DOT11EXT_IHV_CONNECTION_PHASE :

connection_phase_any

Menentukan fase koneksi apa pun.

connection_phase_initial_connection

Menentukan fase koneksi sebelum DLL Ekstensi IHV memulai operasi pra-asosiasi. Untuk informasi selengkapnya tentang operasi pra-asosiasi, lihat Operasi Pra-Asosiasi.

connection_phase_post_l3_connection

Menentukan fase koneksi setelah DLL Ekstensi IHV menyelesaikan operasi pasca-asosiasi. Untuk informasi selengkapnya tentang operasi pasca-asosiasi, lihat Operasi Pasca-Asosiasi.

[out] ppIhvUIRequest

Alamat penunjuk ke struktur DOT11EXT_IHV_UI_REQUEST . DLL Ekstensi IHV harus mengalokasikan buffer untuk struktur DOT11EXT_IHV_UI_REQUEST dengan memanggil Dot11ExtAllocateBuffer.

Nilai kembali

Jika panggilan berhasil, fungsi akan mengembalikan ERROR_SUCCESS. Jika tidak, ia mengembalikan kode kesalahan yang ditentukan dalam Winerror.h.

Keterangan

Ketika Dot11ExtIhvQueryUIRequest dipanggil, DLL Ekstensi IHV harus mengalokasikan dan mengembalikan buffer yang diformat sebagai struktur DOT11EXT_IHV_UI_REQUEST . Dalam situasi ini, DLL harus mengikuti panduan berikut:

DLL Ekstensi IHV harus memanggil Dot11ExtAllocateBuffer untuk mengalokasikan buffer. Setelah DLL kembali dari Dot11ExtIhvQueryUIRequest, sistem operasi bertanggung jawab untuk memanggil Dot11ExtFreeBuffer untuk membebaskan buffer.
DLL Ekstensi IHV memformat struktur DOT11EXT_IHV_UI_REQUEST untuk permintaan UI yang sesuai untuk perubahan status koneksi.
Misalnya, jika connectionPhase diatur ke connection_phase_initial_connection, DLL Ekstensi IHV dapat mengatur anggota struktur DOT11EXT_IHV_UI_REQUEST untuk mereferensikan halaman antarmuka pengguna yang memberi tahu pengguna tentang awal operasi koneksi.

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)